Back to Tool Reference
MCP

product_video.get_generation

Return a design's product videos and their generation status.

Effectread-onlyScopeproduct_video:readPlanGrowth

Parameters

handlestringRequired

The handle from product_video.generate (equals the product design uuid, so a bare design id works too).

wait_secintegerDefault: 0

0 returns an instant snapshot. Positive values long-poll up to that many seconds and return when every video completes/fails or the timeout expires.

Returns

design_idstring
status"pending" | "running" | "complete" | "failed"
doneboolean
videosobject[]

Each: id, channel, video_type, status, video_url, aspect_ratio, error.

Request
json
{
  "name": "product_video.get_generation",
  "arguments": {
    "handle": "c1fe737e-8776-5f39-8c3a-acd25ad5b75e",
    "wait_sec": 50
  }
}