Optional key that makes the request safe to retry: any string up to 128 characters, unique per account,
kept for 24 hours. The same key with the same body replays the first answer (Idempotent-Replayed: true)
instead of creating a second task. See Idempotency.
How much the prompt is rewritten before generation: none keeps your text, basic polishes it, advanced expands it into a detailed shot description. The final text is returned as output.actual_prompt.
When the output is removed, 7 days after completion.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Five API","description":"Five API generates AI videos from text, images, reference assets and clips through one REST API: pick a model, create a task, and receive the MP4 by webhook or polling.","colors":{"primary":"#4F46E5","light":"#818CF8","dark":"#4338CA"},"logo":{"light":"https://mintcdn.com/i2v/KgjMBxZ5eIs4maZs/logo/light.svg?fit=max\u0026auto=format\u0026n=KgjMBxZ5eIs4maZs\u0026q=85\u0026s=817eb9e9373c296b1e9e260b8be26b83","dark":"https://mintcdn.com/i2v/KgjMBxZ5eIs4maZs/logo/dark.svg?fit=max\u0026auto=format\u0026n=KgjMBxZ5eIs4maZs\u0026q=85\u0026s=953eeaf693a62c8e68149421ab01a708"},"favicon":"https://mintcdn.com/i2v/KgjMBxZ5eIs4maZs/favicon.svg?fit=max\u0026auto=format\u0026n=KgjMBxZ5eIs4maZs\u0026q=85\u0026s=43cb28fb3c9f167cf6eb331824c0b41c","api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["bash","python","javascript","go","java","php"],"prefill":true}},"navbar":{"links":[{"href":"mailto:support@fiveapi.ai","label":"Support"}],"primary":{"type":"button","label":"Get API key","href":"https://fiveapi.ai"}},"footer":{"socials":{"website":"https://fiveapi.ai"},"links":[{"header":"Five API","items":[{"label":"Website and console","href":"https://fiveapi.ai"}]},{"header":"Support","items":[{"label":"support@fiveapi.ai","href":"mailto:support@fiveapi.ai"}]}]},"search":{"prompt":"Search the Five API docs..."},"seo":{"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode","download-spec"],"display":"header"},"markdown":{"instructions":["Five API is a video generation REST API. Base URL: https://api.fiveapi.ai. Authenticate with the header Authorization: Bearer \u003cAPI key>; read the key from the FIVEAPI_API_KEY environment variable and never hard-code it.","Every generation is an asynchronous task: POST /v1/{brand}/{version}/{task} returns a queued task, then poll GET /v1/tasks/{task_id} or receive a signed webhook, and download output.video.url before expires_at (7 days).","The OpenAPI spec is at https://docs.fiveapi.ai/api-reference/openapi.yaml. An installable agent skill: npx skills add https://docs.fiveapi.ai"]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"i2v","hasAudioNarration":false,"actualSubdomain":"i2v","customDomains":["testweb2-docs-openapi.test765.com"],"gitSource":{"type":"github","owner":"billions-x","repo":"openapi-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae1570a0dad34c367901cb8"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae15c642f9b16126877fc9c","collectionId":"272cfea9-65cb-4404-a158-a3aec1fcfe27","liveDeploymentHistoryId":"6ae15c642f9b16126877fc9c","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1e60b5ca9b4a2f4636860","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Documentation","count":20},{"language":"default","tag":"API reference","count":18},{"language":"default","tag":"Core concepts","count":7},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Tasks","count":3},{"language":"default","tag":"Video Fast 1.0","count":3},{"language":"default","tag":"Wan 3.0 Spark","count":3},{"language":"default","tag":"Build with AI","count":2},{"language":"default","tag":"Account","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/wan-3-0-spark/image-to-video","slug":"/api-reference/wan-3-0-spark/image-to-video","pageMetadata":{"title":"Wan 3.0 Spark — image to video","description":"Animate an image with **Wan 3.0 Spark**: up to 30 seconds at 480p, 720p or 1080p, with optional synchronized\naudio (`generate_audio`).\n\nThe image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See\n[Input files](/concepts/input-files) and the [Image to video](/guides/image-to-video) guide.\n","deprecated":null,"version":null,"sidebarTitle":"Image to video","openapi":"/api-reference/openapi.yaml post /v1/wan/v3.0-spark/image-to-video","href":"/api-reference/wan-3-0-spark/image-to-video","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Animate an image with \", _jsx(_components.strong, {\n children: \"Wan 3.0 Spark\"\n }), \": up to 30 seconds at 480p, 720p or 1080p, with optional synchronized\\naudio (\", _jsx(_components.code, {\n children: \"generate_audio\"\n }), \").\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See\\n\", _jsx(_components.a, {\n href: \"/concepts/input-files\",\n children: \"Input files\"\n }), \" and the \", _jsx(_components.a, {\n href: \"/guides/image-to-video\",\n children: \"Image to video\"\n }), \" guide.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Wan 3.0 Spark — image to video","description":"Animate an image with **Wan 3.0 Spark**: up to 30 seconds at 480p, 720p or 1080p, with optional synchronized\naudio (`generate_audio`).\n\nThe image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See\n[Input files](/concepts/input-files) and the [Image to video](/guides/image-to-video) guide.\n","deprecated":null,"version":null,"sidebarTitle":"Image to video","openapi":"/api-reference/openapi.yaml post /v1/wan/v3.0-spark/image-to-video","href":"/api-reference/wan-3-0-spark/image-to-video","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Wan 3.0 Spark"],"operationId":"wanSparkImageToVideo","summary":"Wan 3.0 Spark — image to video","x-mint":{"href":"/api-reference/wan-3-0-spark/image-to-video","metadata":{"sidebarTitle":"Image to video"}},"description":"Animate an image with **Wan 3.0 Spark**: up to 30 seconds at 480p, 720p or 1080p, with optional synchronized\naudio (`generate_audio`).\n\nThe image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See\n[Input files](/concepts/input-files) and the [Image to video](/guides/image-to-video) guide.\n","parameters":["19bc8e08-fc02-4e0f-b115-90cdc0021814"],"requestBody":"7d4259dd-290e-4361-acf3-9497467cd0a0","responses":{"200":"383d271e-b00c-48f4-a667-44556af0d48b","400":"f4afca47-a421-43e2-b0c7-7c74beb0a661","401":"ebc7c334-c852-4b8c-90b7-8d8c2aa1f681","402":"21da0f67-2d34-4854-bd4c-a8be74a706fd","403":"5eb1b95a-07ec-44b2-bf16-612a8593b10f","409":"ce9d7146-8ec0-44d5-9c69-7251142615f6","429":"5d91bd5c-80e2-48b8-9cab-ede1332e42af","500":"6fae3263-d93c-42e8-8134-7ab959555977","503":"a765c316-387b-44b8-8190-11a063b0d37e"},"method":"post","type":"path","servers":["eb63f9b9-7090-4399-968a-974bbd0e3388"],"security":["aaefd599-c6ab-4048-ba85-e90f7c4b89c9"],"path":"/v1/wan/v3.0-spark/image-to-video","baseUrlOptions":["https://api.fiveapi.ai"],"title":"Wan 3.0 Spark — image to video","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go","java","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.image_url":"https://assets.example.com/inputs/street-market.png","body.duration":8,"body.resolution":"1080p","body.prompt":"camera drifts right through the market, vendors call out, cloth awnings sway","body.aspect_ratio":"adaptive","body.generate_audio":true,"body.webhook_url":"https://hooks.example.com/fiveapi"}]},"dependencies":{"parameters":{"19bc8e08-fc02-4e0f-b115-90cdc0021814":{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional key that makes the request safe to retry: any string up to 128 characters, unique per account,\nkept for 24 hours. The same key with the same body replays the first answer (`Idempotent-Replayed: true`)\ninstead of creating a second task. See [Idempotency](/concepts/idempotency).\n","schema":{"type":"string","maxLength":128,"examples":["order-8812-attempt-1"],"isRequired":false,"description":"Optional key that makes the request safe to retry: any string up to 128 characters, unique per account,\nkept for 24 hours. The same key with the same body replays the first answer (`Idempotent-Replayed: true`)\ninstead of creating a second task. See [Idempotency](/concepts/idempotency).\n","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Wan 3.0 image-to-video request","required":["image_url","duration","resolution"],"properties":{"image_url":{"type":"string","format":"uri","description":"Public HTTPS URL of a JPG, PNG or WebP image, 360–2,000 px per side, at most 20 MB.","examples":["https://assets.example.com/inputs/street-market.png"],"isRequired":true,"uniqueKey":"image_url","typeLabel":"string\u003curi>"},"duration":{"type":"integer","minimum":2,"maximum":30,"description":"Video length in seconds.","examples":[5],"isRequired":true,"uniqueKey":"duration","typeLabel":"integer"},"resolution":{"type":"string","enum":["480p","720p","1080p"],"description":"Output resolution.","examples":["720p"],"isRequired":true,"uniqueKey":"resolution","typeLabel":"enum\u003cstring>"},"prompt":{"type":"string","maxLength":2000,"description":"Optional. How to animate the image: motion, camera movement, mood, sound.","examples":["camera drifts right through the market, vendors call out, cloth awnings sway"],"uniqueKey":"prompt","typeLabel":"string"},"negative_prompt":{"type":"string","maxLength":2000,"description":"What to keep out of the video.","uniqueKey":"negative_prompt","typeLabel":"string"},"aspect_ratio":{"type":"string","enum":["adaptive","9:16","16:9","1:1","3:4","4:3"],"default":"adaptive","description":"`adaptive` keeps the aspect ratio of the image; any other value crops to that ratio.","uniqueKey":"aspect_ratio","typeLabel":"enum\u003cstring>"},"generate_audio":{"type":"boolean","default":false,"description":"Generate synchronized audio together with the video.","uniqueKey":"generate_audio","typeLabel":"boolean"},"prompt_expansion":{"type":"string","enum":["none","basic","advanced"],"default":"advanced","description":"How much the prompt is rewritten before generation: `none` keeps your text, `basic` polishes it, `advanced` expands it into a detailed shot description. The final text is returned as `output.actual_prompt`.","uniqueKey":"prompt_expansion","typeLabel":"enum\u003cstring>"},"seed":{"type":"integer","description":"Fixed seed for more reproducible results. Omit it for a random seed.","examples":[1733921],"uniqueKey":"seed","typeLabel":"integer"},"webhook_url":{"type":"string","format":"uri","description":"Public HTTPS URL that receives this task's events. Overrides your account's default webhook endpoint.","examples":["https://hooks.example.com/fiveapi"],"uniqueKey":"webhook_url","typeLabel":"string\u003curi>"},"metadata":{"type":"object","additionalProperties":true,"description":"Your own JSON, up to 4,096 bytes when serialized. Returned unchanged on the task and in every webhook.","examples":[{"order_id":"ord_8812"}],"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"Wan 3.0 image-to-video request · object"},"examples":{"with-audio":{"title":"with-audio","value":{"image_url":"https://assets.example.com/inputs/street-market.png","prompt":"camera drifts right through the market, vendors call out, cloth awnings sway","duration":8,"resolution":"1080p","aspect_ratio":"adaptive","generate_audio":true,"webhook_url":"https://hooks.example.com/fiveapi"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"383d271e-b00c-48f4-a667-44556af0d48b":{"description":"The task was accepted and queued.","headers":{"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}},"Idempotent-Replayed":{"description":"`true` when the response was replayed for a repeated `Idempotency-Key`.","schema":{"type":"string","examples":["true"]}}},"content":{"application/json":{"schema":{"type":"object","description":"A generation task. `error` is always present (`null` unless the task failed); other empty members are omitted.","required":["id","object","model","task","status","input","error","credits","created_at"],"properties":{"id":{"type":"string","description":"Task id, `task_` followed by 26 characters.","examples":["task_01J9X7Z0K7Q8W3F2P1N6M5V4R3"],"isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","const":"task","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"model":{"type":"string","description":"The model id the task was created with.","examples":["wan/v3.0-spark/image-to-video"],"isRequired":true,"uniqueKey":"model","typeLabel":"string"},"task":{"type":"string","enum":["text-to-video","image-to-video","reference-to-video","video-extend"],"description":"The task type, the last segment of the model id.","isRequired":true,"uniqueKey":"task","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["queued","processing","completed","failed","cancelled"],"description":"`queued` → `processing` → one of the terminal states `completed`, `failed`, `cancelled`.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"input":{"type":"object","additionalProperties":true,"description":"The accepted request body, without `webhook_url` and `metadata`.","isRequired":true,"uniqueKey":"input","typeLabel":"object"},"error":{"oneOf":[{"type":"object","description":"Why the task failed. `null` unless `status` is `failed`.","required":["code","message","retryable"],"properties":{"code":{"type":"string","enum":["input_fetch_failed","input_invalid","content_moderation_rejected","generation_failed","timeout","service_unavailable"],"description":"Stable failure code. See [Errors](/concepts/errors#task-failures).","isRequired":true,"uniqueKey":"error.oneOf.0.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable detail. It may change; branch on `code`.","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"True when submitting the same request again may succeed.","isRequired":true,"uniqueKey":"error.oneOf.0.retryable","typeLabel":"boolean"},"reason":{"type":"string","enum":["ip","audio_copyright","public_figure"],"description":"For `content_moderation_rejected`: the category, when classified.","uniqueKey":"error.oneOf.0.reason","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","description":"Why the task failed. `null` unless `status` is `failed`.","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"object | null"},"credits":{"type":"object","required":["estimated"],"properties":{"estimated":{"type":"integer","format":"int64","description":"Credits held when the task was accepted.","examples":[60],"isRequired":true,"uniqueKey":"credits.estimated","typeLabel":"integer\u003cint64>"},"charged":{"type":"integer","format":"int64","description":"Credits charged. Set when the task completes; absent on failed and cancelled tasks, whose hold was released.","examples":[60],"uniqueKey":"credits.charged","typeLabel":"integer\u003cint64>"}},"isRequired":true,"uniqueKey":"credits","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","description":"When the task was created.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"output":{"type":"object","description":"The result. Present on `completed` tasks until `expires_at`.","properties":{"video":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Download URL of the MP4, valid until `expires_at`.","examples":["https://openassets.fiveapi.ai/x2v/results/551fe9fa/openapi_1793171336.mp4"],"uniqueKey":"output.video.url","typeLabel":"string\u003curi>"},"content_type":{"type":"string","examples":["video/mp4"],"uniqueKey":"output.video.content_type","typeLabel":"string"},"file_size":{"type":"integer","format":"int64","description":"Size in bytes.","uniqueKey":"output.video.file_size","typeLabel":"integer\u003cint64>"},"width":{"type":"integer","description":"Width in pixels.","uniqueKey":"output.video.width","typeLabel":"integer"},"height":{"type":"integer","description":"Height in pixels.","uniqueKey":"output.video.height","typeLabel":"integer"},"duration":{"type":"number","description":"Length in seconds.","uniqueKey":"output.video.duration","typeLabel":"number"},"fps":{"type":"integer","description":"Frames per second.","uniqueKey":"output.video.fps","typeLabel":"integer"},"cover_url":{"type":"string","format":"uri","description":"First-frame image (JPG), when available.","uniqueKey":"output.video.cover_url","typeLabel":"string\u003curi>"}},"uniqueKey":"output.video","typeLabel":"object"},"actual_prompt":{"type":"string","description":"The prompt after expansion, when it was rewritten.","uniqueKey":"output.actual_prompt","typeLabel":"string"},"seed":{"type":"integer","format":"int64","description":"The seed used, when the model reports it.","uniqueKey":"output.seed","typeLabel":"integer\u003cint64>"}},"uniqueKey":"output","typeLabel":"object"},"queue":{"type":"object","description":"Present while the task is `queued`.","properties":{"position":{"type":"integer","description":"Position in the model's queue; lower starts sooner.","examples":[3],"uniqueKey":"queue.position","typeLabel":"integer"}},"uniqueKey":"queue","typeLabel":"object"},"webhook_url":{"type":"string","format":"uri","description":"The webhook URL sent with the task.","uniqueKey":"webhook_url","typeLabel":"string\u003curi>"},"metadata":{"type":"object","additionalProperties":true,"description":"The metadata sent with the task.","uniqueKey":"metadata","typeLabel":"object"},"started_at":{"type":"string","format":"date-time","description":"When generation started.","uniqueKey":"started_at","typeLabel":"string\u003cdate-time>"},"completed_at":{"type":"string","format":"date-time","description":"When the task reached `completed`, `failed` or `cancelled`.","uniqueKey":"completed_at","typeLabel":"string\u003cdate-time>"},"expires_at":{"type":"string","format":"date-time","description":"When the output is removed, 7 days after completion.","uniqueKey":"expires_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"task_01J9XC4D5E6F7G8H9J0K1L2M3N","object":"task","model":"wan/v3.0-spark/image-to-video","task":"image-to-video","status":"queued","input":{"image_url":"https://assets.example.com/inputs/street-market.png","prompt":"camera drifts right through the market, vendors call out, cloth awnings sway","duration":8,"resolution":"1080p","aspect_ratio":"adaptive","generate_audio":true},"error":null,"credits":{"estimated":192},"queue":{"position":3},"webhook_url":"https://hooks.example.com/fiveapi","created_at":"2026-10-23T06:21:02.127Z"},"examples":{"Example":{"title":"Example","value":{"id":"task_01J9XC4D5E6F7G8H9J0K1L2M3N","object":"task","model":"wan/v3.0-spark/image-to-video","task":"image-to-video","status":"queued","input":{"image_url":"https://assets.example.com/inputs/street-market.png","prompt":"camera drifts right through the market, vendors call out, cloth awnings sway","duration":8,"resolution":"1080p","aspect_ratio":"adaptive","generate_audio":true},"error":null,"credits":{"estimated":192},"queue":{"position":3},"webhook_url":"https://hooks.example.com/fiveapi","created_at":"2026-10-23T06:21:02.127Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"f4afca47-a421-43e2-b0c7-7c74beb0a661":{"description":"The request is malformed or breaks the model's rules: `invalid_json`, `missing_parameter`,\n`invalid_parameter`, `unsupported_model`, `url_not_allowed` or `idempotency_key_reused`. Nothing was\ncharged.\n","headers":{"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","conflict_error","rate_limit_error","api_error"],"description":"The error category.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, never on `message`.","examples":["insufficient_credits"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. It may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Same as the `X-Request-Id` header.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The request field at fault, when there is one.","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra members for some codes, for example `required` and `available` on `insufficient_credits`.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missing_parameter":{"title":"missing_parameter","value":{"error":{"type":"invalid_request_error","code":"missing_parameter","message":"missing required parameter: duration","param":"duration","request_id":"req_01M5KN36M1JPANPMDW0HEWMMB0"}}},"invalid_parameter":{"title":"invalid_parameter","value":{"error":{"type":"invalid_request_error","code":"invalid_parameter","message":"duration 20 s at 768p is not available on this model","param":"duration","request_id":"req_01M5KN36P1JPANPMDW0HEWMM07"}}},"url_not_allowed":{"title":"url_not_allowed","value":{"error":{"type":"invalid_request_error","code":"url_not_allowed","message":"image_url must use https","param":"image_url","request_id":"req_01M5KPQ1HMDVX7324R9FQFH87S"}}},"idempotency_key_reused":{"title":"idempotency_key_reused","value":{"error":{"type":"invalid_request_error","code":"idempotency_key_reused","message":"this Idempotency-Key was already used with a different request body","param":"Idempotency-Key","request_id":"req_01M5KN36RZ8C1Q2T3V4W5X6Y7Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"ebc7c334-c852-4b8c-90b7-8d8c2aa1f681":{"description":"The API key is missing, unknown, revoked or expired (`invalid_api_key`, `api_key_revoked`, `api_key_expired`).","headers":{"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","conflict_error","rate_limit_error","api_error"],"description":"The error category.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, never on `message`.","examples":["insufficient_credits"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. It may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Same as the `X-Request-Id` header.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The request field at fault, when there is one.","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra members for some codes, for example `required` and `available` on `insufficient_credits`.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalid_api_key":{"title":"invalid_api_key","value":{"error":{"type":"authentication_error","code":"invalid_api_key","message":"missing API key: send Authorization: Bearer sk_live_… (or x-api-key)","request_id":"req_01M5KN14MXD6SJ01ZQ2FPS6Y8X"}}},"api_key_revoked":{"title":"api_key_revoked","value":{"error":{"type":"authentication_error","code":"api_key_revoked","message":"this API key has been revoked","request_id":"req_01M5KN14PY5YH5QPA2QS7Y07Y4"}}}},"exampleType":"examples"}},"exampleType":"examples"},"21da0f67-2d34-4854-bd4c-a8be74a706fd":{"description":"Your spendable balance does not cover the estimated price (`insufficient_credits`). `details` carries `required` and `available`.","headers":{"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","conflict_error","rate_limit_error","api_error"],"description":"The error category.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, never on `message`.","examples":["insufficient_credits"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. It may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Same as the `X-Request-Id` header.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The request field at fault, when there is one.","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra members for some codes, for example `required` and `available` on `insufficient_credits`.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"billing_error","code":"insufficient_credits","message":"this task needs 60 credits, 25 are available","request_id":"req_01M5KPQ11B3NS7R5ZFFVZBD4W3","details":{"required":60,"available":25}}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"billing_error","code":"insufficient_credits","message":"this task needs 60 credits, 25 are available","request_id":"req_01M5KPQ11B3NS7R5ZFFVZBD4W3","details":{"required":60,"available":25}}}}},"exampleType":"examples"}},"exampleType":"examples"},"5eb1b95a-07ec-44b2-bf16-612a8593b10f":{"description":"The key lacks the scope (`insufficient_scope`), the caller's IP address is not on the key's allowlist\n(`ip_not_allowed`), or the account is suspended or not approved yet (`account_suspended`,\n`account_not_active`).\n","headers":{"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","conflict_error","rate_limit_error","api_error"],"description":"The error category.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, never on `message`.","examples":["insufficient_credits"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. It may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Same as the `X-Request-Id` header.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The request field at fault, when there is one.","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra members for some codes, for example `required` and `available` on `insufficient_credits`.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"insufficient_scope":{"title":"insufficient_scope","value":{"error":{"type":"permission_error","code":"insufficient_scope","message":"this key does not have the video:write scope","request_id":"req_01M5KN14S3T4U5V6W7X8Y9Z0A1"}}},"ip_not_allowed":{"title":"ip_not_allowed","value":{"error":{"type":"permission_error","code":"ip_not_allowed","message":"requests from 203.0.113.9 are not allowed for this key","request_id":"req_01M5KN14T4U5V6W7X8Y9Z0A1B2"}}},"account_not_active":{"title":"account_not_active","value":{"error":{"type":"permission_error","code":"account_not_active","message":"this account is not active yet (pending approval)","request_id":"req_01M5KN14U5V6W7X8Y9Z0A1B2C3"}}}},"exampleType":"examples"}},"exampleType":"examples"},"ce9d7146-8ec0-44d5-9c69-7251142615f6":{"description":"The task is already `completed` or `failed` (`task_already_terminal`), or a request with the same `Idempotency-Key` is still running (`idempotency_in_progress`).","headers":{"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","conflict_error","rate_limit_error","api_error"],"description":"The error category.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, never on `message`.","examples":["insufficient_credits"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. It may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Same as the `X-Request-Id` header.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The request field at fault, when there is one.","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra members for some codes, for example `required` and `available` on `insufficient_credits`.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"task_already_terminal":{"title":"task_already_terminal","value":{"error":{"type":"conflict_error","code":"task_already_terminal","message":"task task_01J9X7Z0K7Q8W3F2P1N6M5V4R3 is already completed","request_id":"req_01M5KN37A1B2C3D4E5F6G7H8J9"}}},"idempotency_in_progress":{"title":"idempotency_in_progress","value":{"error":{"type":"conflict_error","code":"idempotency_in_progress","message":"a request with this Idempotency-Key is still being processed","request_id":"req_01M5KN37B2C3D4E5F6G7H8J9K0"}}}},"exampleType":"examples"}},"exampleType":"examples"},"5d91bd5c-80e2-48b8-9cab-ede1332e42af":{"description":"A limit of your plan was reached: the request rate (`rate_limit_exceeded`), the number of queued and\nprocessing tasks (`concurrency_limit_exceeded`) or the daily credit cap (`daily_cap_exceeded`). Wait\n`Retry-After` seconds before retrying.\n","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","examples":[10]}},"X-RateLimit-Limit":{"description":"Requests per minute allowed for your account (or the key's lower ceiling).","schema":{"type":"integer","examples":[300]}},"X-RateLimit-Remaining":{"description":"Requests left in the current minute.","schema":{"type":"integer","examples":[287]}},"X-RateLimit-Reset":{"description":"Unix time in seconds when the minute window resets.","schema":{"type":"integer","format":"int64","examples":[1792736640]}},"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","conflict_error","rate_limit_error","api_error"],"description":"The error category.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, never on `message`.","examples":["insufficient_credits"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. It may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Same as the `X-Request-Id` header.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The request field at fault, when there is one.","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra members for some codes, for example `required` and `available` on `insufficient_credits`.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"rate_limit_exceeded":{"title":"rate_limit_exceeded","value":{"error":{"type":"rate_limit_error","code":"rate_limit_exceeded","message":"rate limit exceeded for this account (10 rps, 300 rpm)","request_id":"req_01M5KN37C3D4E5F6G7H8J9K0L1"}}},"concurrency_limit_exceeded":{"title":"concurrency_limit_exceeded","value":{"error":{"type":"rate_limit_error","code":"concurrency_limit_exceeded","message":"the account already has 20 tasks queued or processing (plan limit 20)","request_id":"req_01M5KN37D4E5F6G7H8J9K0L1M2"}}},"daily_cap_exceeded":{"title":"daily_cap_exceeded","value":{"error":{"type":"rate_limit_error","code":"daily_cap_exceeded","message":"this account's daily credit cap (5000) would be exceeded","request_id":"req_01M5KN37E5F6G7H8J9K0L1M2N3"}}}},"exampleType":"examples"}},"exampleType":"examples"},"6fae3263-d93c-42e8-8134-7ab959555977":{"description":"An unexpected error (`internal_error`). Retry with backoff and the same `Idempotency-Key`.","headers":{"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","conflict_error","rate_limit_error","api_error"],"description":"The error category.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, never on `message`.","examples":["insufficient_credits"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. It may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Same as the `X-Request-Id` header.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The request field at fault, when there is one.","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra members for some codes, for example `required` and `available` on `insufficient_credits`.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"api_error","code":"internal_error","message":"an internal error occurred; retry with the same Idempotency-Key","request_id":"req_01M5KN37F6G7H8J9K0L1M2N3P4"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"api_error","code":"internal_error","message":"an internal error occurred; retry with the same Idempotency-Key","request_id":"req_01M5KN37F6G7H8J9K0L1M2N3P4"}}}},"exampleType":"examples"}},"exampleType":"examples"},"a765c316-387b-44b8-8190-11a063b0d37e":{"description":"Generation capacity is temporarily unavailable (`service_unavailable`). Nothing was charged; retry after `Retry-After` seconds with the same `Idempotency-Key`.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","examples":[10]}},"X-Request-Id":{"description":"Id of this request (`req_...`). Quote it when you contact support.","schema":{"type":"string","examples":["req_01M5KPY92Y148QP01G532MM3BH"]}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","conflict_error","rate_limit_error","api_error"],"description":"The error category.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Stable machine-readable code. Branch on this, never on `message`.","examples":["insufficient_credits"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. It may change.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Same as the `X-Request-Id` header.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The request field at fault, when there is one.","uniqueKey":"error.param","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Extra members for some codes, for example `required` and `available` on `insufficient_credits`.","uniqueKey":"error.details","typeLabel":"object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"type":"api_error","code":"service_unavailable","message":"the pipeline cannot take new tasks right now, retry with the same Idempotency-Key","request_id":"req_01M5KPY92Y148QP01G532MM3BH"}},"examples":{"Example":{"title":"Example","value":{"error":{"type":"api_error","code":"service_unavailable","message":"the pipeline cannot take new tasks right now, retry with the same Idempotency-Key","request_id":"req_01M5KPY92Y148QP01G532MM3BH"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"aaefd599-c6ab-4048-ba85-e90f7c4b89c9":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your API key from the [developer console](https://fiveapi.ai), sent as `Authorization: Bearer sk_live_...`.\nThe `x-api-key: sk_live_...` header is accepted as an alternative.\n","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"eb63f9b9-7090-4399-968a-974bbd0e3388":{"url":"https://api.fiveapi.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your API key from the [developer console](https://fiveapi.ai), sent as `Authorization: Bearer sk_live_...`.\nThe `x-api-key: sk_live_...` header is accepted as an alternative.\n","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your API key from the [developer console](https://fiveapi.ai), sent as `Authorization: Bearer sk_live_...`.\nThe `x-api-key: sk_live_...` header is accepted as an alternative.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"i2v","siteName":"Five API","title":"Wan 3.0 Spark — image to video - Five API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T12:09:50.799Z","originalFileLocation":"api-reference/wan-3-0-spark/image-to-video.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Animate an image with Wan 3.0 Spark: up to 30 seconds at 480p, 720p or 1080p, with optional synchronized audio (generate_audio). The image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See Input files and the Image to video guide.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Five API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Wan 3.0 Spark — image to video - Five API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Animate an image with Wan 3.0 Spark: up to 30 seconds at 480p, 720p or 1080p, with optional synchronized audio (generate_audio). The image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See Input files and the Image to video guide.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Five API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://i2v.mintlify.app/_mintlify/api/og/v2?division=Wan+3.0+Spark\u0026amp;title=Wan+3.0+Spark+%E2%80%94+image+to+video\u0026amp;description=Animate+an+image+with+**Wan+3.0+Spark**%3A+up+to+30+seconds+at+480p%2C+720p+or+1080p%2C+with+optional+synchronized%0Aaudio+%28%60generate_audio%60%29.%0A%0AThe+image+must+be+a+publ\u0026amp;theme=9d2dc752b2506fd259767f0d\u0026amp;signature=43b575b2d693303eb012de6d8b3820dfb4eb29bea59a7b0a1c502253e4964efe\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Wan 3.0 Spark — image to video - Five API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Animate an image with Wan 3.0 Spark: up to 30 seconds at 480p, 720p or 1080p, with optional synchronized audio (generate_audio). The image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See Input files and the Image to video guide.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://i2v.mintlify.app/_mintlify/api/og/v2?division=Wan+3.0+Spark\u0026amp;title=Wan+3.0+Spark+%E2%80%94+image+to+video\u0026amp;description=Animate+an+image+with+**Wan+3.0+Spark**%3A+up+to+30+seconds+at+480p%2C+720p+or+1080p%2C+with+optional+synchronized%0Aaudio+%28%60generate_audio%60%29.%0A%0AThe+image+must+be+a+publ\u0026amp;theme=9d2dc752b2506fd259767f0d\u0026amp;signature=43b575b2d693303eb012de6d8b3820dfb4eb29bea59a7b0a1c502253e4964efe\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/i2v/sgHTaltpoqdqdsUg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Five API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F46E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/wan-3-0-spark/image-to-video.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://testweb2-docs-openapi.test765.com/#organization\",\"name\":\"Five API\",\"url\":\"https://testweb2-docs-openapi.test765.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/i2v/KgjMBxZ5eIs4maZs/logo/light.svg?fit=max\u0026auto=format\u0026n=KgjMBxZ5eIs4maZs\u0026q=85\u0026s=817eb9e9373c296b1e9e260b8be26b83\"}},{\"@type\":\"WebSite\",\"@id\":\"https://testweb2-docs-openapi.test765.com#website\",\"name\":\"Five API\",\"url\":\"https://testweb2-docs-openapi.test765.com\",\"publisher\":{\"@id\":\"https://testweb2-docs-openapi.test765.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video#webpage\",\"url\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video\",\"name\":\"Wan 3.0 Spark — image to video\",\"description\":\"Animate an image with Wan 3.0 Spark: up to 30 seconds at 480p, 720p or 1080p, with optional synchronized audio (generate_audio). The image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See Input files and the Image to video guide.\",\"dateModified\":\"2026-10-28T12:09:50.799Z\",\"isPartOf\":{\"@id\":\"https://testweb2-docs-openapi.test765.com#website\"},\"breadcrumb\":{\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Wan 3.0 Spark\",\"item\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/text-to-video\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Wan 3.0 Spark — image to video\",\"item\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video#apireference\",\"headline\":\"Wan 3.0 Spark — image to video\",\"name\":\"Wan 3.0 Spark — image to video\",\"description\":\"Animate an image with Wan 3.0 Spark: up to 30 seconds at 480p, 720p or 1080p, with optional synchronized audio (generate_audio). The image must be a public HTTPS URL of a JPG, PNG or WebP file, 360–2,000 px per side, at most 20 MB. See Input files and the Image to video guide.\",\"url\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video\",\"mainEntityOfPage\":{\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/wan-3-0-spark/image-to-video#webpage\"},\"dateModified\":\"2026-10-28T12:09:50.799Z\",\"publisher\":{\"@id\":\"https://testweb2-docs-openapi.test765.com/#organization\"},\"isPartOf\":{\"@id\":\"https://testweb2-docs-openapi.test765.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Five API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Five API","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"API reference","sidebarTitle":"Introduction","href":"/api-reference/introduction"}]},{"group":"Video Fast 1.0","pages":[{"title":"Video Fast 1.0 — text to video","deprecated":null,"version":null,"sidebarTitle":"Text to video","openapi":"/api-reference/openapi.yaml post /v1/video-fast/v1.0/text-to-video","href":"/api-reference/video-fast-1-0/text-to-video"},{"title":"Video Fast 1.0 — image to video","deprecated":null,"version":null,"sidebarTitle":"Image to video","openapi":"/api-reference/openapi.yaml post /v1/video-fast/v1.0/image-to-video","href":"/api-reference/video-fast-1-0/image-to-video"},{"title":"Video Fast 1.0 — reference to video","deprecated":null,"version":null,"sidebarTitle":"Reference to video","openapi":"/api-reference/openapi.yaml post /v1/video-fast/v1.0/reference-to-video","href":"/api-reference/video-fast-1-0/reference-to-video"}]},{"group":"Wan 3.0 Spark","pages":[{"title":"Wan 3.0 Spark — text to video","description":"Generate a video from a text prompt with **Wan 3.0 Spark**: native videos up to 30 seconds with richer\ndetail, at 480p, 720p or 1080p, with optional synchronized audio (`generate_audio`).\n\nGuide: [Text to video](/guides/text-to-video).\n","deprecated":null,"version":null,"sidebarTitle":"Text to video","openapi":"/api-reference/openapi.yaml post /v1/wan/v3.0-spark/text-to-video","href":"/api-reference/wan-3-0-spark/text-to-video"},{"title":"Wan 3.0 Spark — image to video","deprecated":null,"version":null,"sidebarTitle":"Image to video","openapi":"/api-reference/openapi.yaml post /v1/wan/v3.0-spark/image-to-video","href":"/api-reference/wan-3-0-spark/image-to-video"},{"title":"Wan 3.0 Spark — reference to video","description":"Generate a video from reference assets with **Wan 3.0 Spark**: up to 30 seconds at 480p, 720p or 1080p.\n\nSend at least one asset. The prompt names the assets by their position: `@Image1` is the first item of\n`reference_images`, `@Video1` the first item of `reference_videos`, `@Audio1` the first item of\n`reference_audios`. `image_url` is not accepted on this task type.\n\n| Asset | Count | Limits |\n|---|---|---|\n| `reference_images` | up to 10 | JPG, PNG or WebP, at most 20 MB each |\n| `reference_videos` | up to 5 | at most 100 MB each |\n| `reference_audios` | up to 5 | at most 15 MB each |\n\nGuide: [Reference to video](/guides/reference-to-video).\n","deprecated":null,"version":null,"sidebarTitle":"Reference to video","openapi":"/api-reference/openapi.yaml post /v1/wan/v3.0-spark/reference-to-video","href":"/api-reference/wan-3-0-spark/reference-to-video"}]},{"group":"Wan 3.0 Prime Spark","pages":[{"title":"Wan 3.0 Prime Spark — text to video","deprecated":null,"version":null,"sidebarTitle":"Text to video","openapi":"/api-reference/openapi.yaml post /v1/wan/v3.0-prime-spark/text-to-video","href":"/api-reference/wan-3-0-prime-spark/text-to-video"},{"title":"Wan 3.0 Prime Spark — image to video","deprecated":null,"version":null,"sidebarTitle":"Image to video","openapi":"/api-reference/openapi.yaml post /v1/wan/v3.0-prime-spark/image-to-video","href":"/api-reference/wan-3-0-prime-spark/image-to-video"}]},{"group":"Video Fast Extend 1.1","pages":[{"title":"Video Fast Extend 1.1 — video extend","deprecated":null,"version":null,"sidebarTitle":"Video extend","openapi":"/api-reference/openapi.yaml post /v1/video-fast/v1.1/video-extend","href":"/api-reference/video-fast-extend-1-1/video-extend"}]},{"group":"Tasks","pages":[{"title":"Get a task","deprecated":null,"version":null,"sidebarTitle":"Get task","openapi":"/api-reference/openapi.yaml get /v1/tasks/{task_id}","href":"/api-reference/tasks/get-task"},{"title":"List tasks","deprecated":null,"version":null,"sidebarTitle":"List tasks","openapi":"/api-reference/openapi.yaml get /v1/tasks","href":"/api-reference/tasks/list-tasks"},{"title":"Cancel a task","deprecated":null,"version":null,"sidebarTitle":"Cancel task","openapi":"/api-reference/openapi.yaml post /v1/tasks/{task_id}/cancel","href":"/api-reference/tasks/cancel-task"}]},{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"sidebarTitle":"List models","openapi":"/api-reference/openapi.yaml get /v1/models","href":"/api-reference/models/list-models"},{"title":"Get a model","deprecated":null,"version":null,"sidebarTitle":"Get model","openapi":"/api-reference/openapi.yaml get /v1/models/{brand}/{version}/{task}","href":"/api-reference/models/get-model"}]},{"group":"Account","pages":[{"title":"Get the account","deprecated":null,"version":null,"sidebarTitle":"Get account","openapi":"/api-reference/openapi.yaml get /v1/account","href":"/api-reference/account/get-account"},{"title":"Get daily usage","deprecated":null,"version":null,"sidebarTitle":"Get usage","openapi":"/api-reference/openapi.yaml get /v1/account/usage","href":"/api-reference/account/get-usage"}]},{"group":"Webhooks","pages":[{"title":"Task events","openapi":"api-reference/openapi.yaml webhook taskEvent","href":"/api-reference/webhooks/task-events"}]}]}]},"title":"Wan 3.0 Spark — image to video - Five API","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}