Animate an image with Wan 3.0 Prime Spark: Wan 3.0 quality at the full 30 seconds, noticeably faster
than Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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.
POST
/
v1
/
wan
/
v3.0-prime-spark
/
image-to-video
Wan 3.0 Prime Spark — image to video
curl --request POST \ --url https://api.fiveapi.ai/v1/wan/v3.0-prime-spark/image-to-video \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "image_url": "https://assets.example.com/inputs/product-shot.webp", "prompt": "slow 360-degree orbit around the bottle, studio lighting", "duration": 6, "resolution": "1080p", "generate_audio": false, "prompt_expansion": "none", "seed": 1733921}'
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. Omitted, it is advanced. The rewritten text is not returned.
Fixed seed, 0 to 2147483647; omit it for a random seed (the seed used is not returned). A seed reproduces a result only together with the exact prompt the model saw: send prompt_expansion: none for reproducible runs - with basic or advanced the prompt is rewritten by a language model on every request, so the same seed gives a different video. Without expansion the quality depends entirely on your prompt: write a detailed, cinematic prompt yourself, or keep expansion on and accept that runs vary. Video Fast 1.0 reproduces the video exactly; Wan 3.0 Spark / Prime Spark make it reproducible, not guaranteed identical. Every model takes it.
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/sjmdsydOIQ8k9Qu8/logo/light.svg?fit=max\u0026auto=format\u0026n=sjmdsydOIQ8k9Qu8\u0026q=85\u0026s=ba568ffb395958bdd81aac9c770a69c0","dark":"https://mintcdn.com/i2v/sjmdsydOIQ8k9Qu8/logo/dark.svg?fit=max\u0026auto=format\u0026n=sjmdsydOIQ8k9Qu8\u0026q=85\u0026s=7a6aa76adbaf06f287dcaf68a0e2bf45"},"favicon":"https://mintcdn.com/i2v/sjmdsydOIQ8k9Qu8/favicon.png?fit=max\u0026auto=format\u0026n=sjmdsydOIQ8k9Qu8\u0026q=85\u0026s=600d1293a7eb86a478b6ff6b43aa7c16","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":["docs.fiveapi.ai"],"gitSource":{"type":"github","owner":"billions-x","repo":"openapi-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae1570a0dad34c367901cb8"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae863b80e678b1f73a08bc4","collectionId":"8a7821b8-73f3-4b6a-973f-968ce1676ecc","liveDeploymentHistoryId":"6ae863b80e678b1f73a08bc4","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae99bdc70a247aacc44c49b","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Documentation","count":19},{"language":"default","tag":"API reference","count":19},{"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 Prime Spark","count":3},{"language":"default","tag":"Wan 3.0 Spark","count":3},{"language":"default","tag":"Account","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"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":"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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#assistant-entry,#assistant-entry-mobile,[data-layout-item=assistant-entry]{display:none}"}],"page":{"pagePath":"api-reference/wan-3-0-prime-spark/image-to-video","slug":"/api-reference/wan-3-0-prime-spark/image-to-video","pageMetadata":{"title":"Wan 3.0 Prime Spark — image to video","description":"Animate an image with **Wan 3.0 Prime Spark**: Wan 3.0 quality at the full 30 seconds, noticeably faster\nthan Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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-prime-spark/image-to-video","href":"/api-reference/wan-3-0-prime-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 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 Prime Spark\"\n }), \": Wan 3.0 quality at the full 30 seconds, noticeably faster\\nthan Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized audio.\"]\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 Prime Spark — image to video","description":"Animate an image with **Wan 3.0 Prime Spark**: Wan 3.0 quality at the full 30 seconds, noticeably faster\nthan Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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-prime-spark/image-to-video","href":"/api-reference/wan-3-0-prime-spark/image-to-video","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Wan 3.0 Prime Spark"],"operationId":"wanPrimeSparkImageToVideo","summary":"Wan 3.0 Prime Spark — image to video","x-mint":{"href":"/api-reference/wan-3-0-prime-spark/image-to-video","metadata":{"sidebarTitle":"Image to video"}},"description":"Animate an image with **Wan 3.0 Prime Spark**: Wan 3.0 quality at the full 30 seconds, noticeably faster\nthan Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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":["59870d20-3ee1-475c-9e69-c0c95f14c7b8"],"requestBody":"a616c054-a853-4c06-8e2c-5881111ff869","responses":{"200":"94ba3a60-fe2a-46dd-a28e-54c39721ea78","400":"5ca79afc-8b97-4905-87ef-848cdb0b8319","401":"bdb773ae-cf23-45a0-8381-2d31aa005da8","402":"e3c8fd20-a387-43bd-9b5e-7c88f94f2cc0","403":"aad9b7ad-80a3-47b5-a318-6ead491db1c5","409":"24ce08af-2e57-4d93-aca1-252dda886933","429":"bbe9232d-ba3b-4c55-a569-bfea54c28bbb","500":"5e27738a-4860-45b7-b3a7-88ab8973e0d0","503":"a8da1f42-11fa-4c6c-8e33-74ea38828de8"},"method":"post","type":"path","servers":["0e5c1744-8f81-4abf-9952-ca188e3f192a"],"security":["284c627a-1d7c-49fc-865b-457e3dfc246f"],"path":"/v1/wan/v3.0-prime-spark/image-to-video","baseUrlOptions":["https://api.fiveapi.ai"],"title":"Wan 3.0 Prime 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/product-shot.webp","body.duration":6,"body.resolution":"1080p","body.prompt":"slow 360-degree orbit around the bottle, studio lighting","body.generate_audio":false,"body.prompt_expansion":"none","body.seed":1733921}]},"dependencies":{"parameters":{"59870d20-3ee1-475c-9e69-c0c95f14c7b8":{"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"},"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. Omitted, it is `adaptive`.","uniqueKey":"aspect_ratio","typeLabel":"enum\u003cstring>"},"generate_audio":{"type":"boolean","default":false,"description":"Generate synchronized audio together with the video. Omitted, it is `false`.","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. Omitted, it is `advanced`. The rewritten text is not returned.","uniqueKey":"prompt_expansion","typeLabel":"enum\u003cstring>"},"seed":{"type":"integer","minimum":0,"maximum":2147483647,"description":"Fixed seed, 0 to 2147483647; omit it for a random seed (the seed used is not returned). A seed reproduces a result only together with the exact prompt the model saw: send `prompt_expansion: none` for reproducible runs - with `basic` or `advanced` the prompt is rewritten by a language model on every request, so the same seed gives a different video. Without expansion the quality depends entirely on your prompt: write a detailed, cinematic prompt yourself, or keep expansion on and accept that runs vary. Video Fast 1.0 reproduces the video exactly; Wan 3.0 Spark / Prime Spark make it reproducible, not guaranteed identical. Every model takes it.","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":{"product-orbit":{"title":"product-orbit","value":{"image_url":"https://assets.example.com/inputs/product-shot.webp","prompt":"slow 360-degree orbit around the bottle, studio lighting","duration":6,"resolution":"1080p","generate_audio":false,"prompt_expansion":"none","seed":1733921}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"94ba3a60-fe2a-46dd-a28e-54c39721ea78":{"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/Five_API_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"}},"uniqueKey":"output","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_01J9XF7G8H9J0K1L2M3N4P5Q6R","object":"task","model":"wan/v3.0-prime-spark/image-to-video","task":"image-to-video","status":"queued","input":{"image_url":"https://assets.example.com/inputs/product-shot.webp","prompt":"slow 360-degree orbit around the bottle, studio lighting","duration":6,"resolution":"1080p","generate_audio":false,"seed":1733921},"error":null,"credits":{"estimated":192},"created_at":"2026-10-23T07:40:12.000Z"},"examples":{"Example":{"title":"Example","value":{"id":"task_01J9XF7G8H9J0K1L2M3N4P5Q6R","object":"task","model":"wan/v3.0-prime-spark/image-to-video","task":"image-to-video","status":"queued","input":{"image_url":"https://assets.example.com/inputs/product-shot.webp","prompt":"slow 360-degree orbit around the bottle, studio lighting","duration":6,"resolution":"1080p","generate_audio":false,"seed":1733921},"error":null,"credits":{"estimated":192},"created_at":"2026-10-23T07:40:12.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"5ca79afc-8b97-4905-87ef-848cdb0b8319":{"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, a short string (never a number). 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"},"bdb773ae-cf23-45a0-8381-2d31aa005da8":{"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, a short string (never a number). 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"},"e3c8fd20-a387-43bd-9b5e-7c88f94f2cc0":{"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, a short string (never a number). 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"},"aad9b7ad-80a3-47b5-a318-6ead491db1c5":{"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, a short string (never a number). 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 lacks 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"},"24ce08af-2e57-4d93-aca1-252dda886933":{"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, a short string (never a number). 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"},"bbe9232d-ba3b-4c55-a569-bfea54c28bbb":{"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, a short string (never a number). 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"},"5e27738a-4860-45b7-b3a7-88ab8973e0d0":{"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, a short string (never a number). 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"},"a8da1f42-11fa-4c6c-8e33-74ea38828de8":{"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, a short string (never a number). 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":{"284c627a-1d7c-49fc-865b-457e3dfc246f":{"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":{"0e5c1744-8f81-4abf-9952-ca188e3f192a":{"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 Prime Spark — image to video - Five API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T08:31:27.973Z","originalFileLocation":"api-reference/wan-3-0-prime-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 Prime Spark: Wan 3.0 quality at the full 30 seconds, noticeably faster than Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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/q-zQTJUHDH_Z9YpV/_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/q-zQTJUHDH_Z9YpV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/i2v/q-zQTJUHDH_Z9YpV/_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/q-zQTJUHDH_Z9YpV/_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/q-zQTJUHDH_Z9YpV/_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/q-zQTJUHDH_Z9YpV/_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/q-zQTJUHDH_Z9YpV/_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/q-zQTJUHDH_Z9YpV/_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/q-zQTJUHDH_Z9YpV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Wan 3.0 Prime Spark — image to video - Five API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Animate an image with Wan 3.0 Prime Spark: Wan 3.0 quality at the full 30 seconds, noticeably faster than Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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://docs.fiveapi.ai/api-reference/wan-3-0-prime-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+Prime+Spark\u0026amp;title=Wan+3.0+Prime+Spark+%E2%80%94+image+to+video\u0026amp;description=Animate+an+image+with+**Wan+3.0+Prime+Spark**%3A+Wan+3.0+quality+at+the+full+30+seconds%2C+noticeably+faster%0Athan+Wan+3.0+Spark.+480p%2C+720p+or+1080p%2C+with+optional+\u0026amp;theme=0751c57ef6bcb47b6f12b009\u0026amp;signature=1ecf1418248097c5a2376183eb26524d1fba29d4837165087f6f7db4d1d31523\">\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 Prime Spark — image to video - Five API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Animate an image with Wan 3.0 Prime Spark: Wan 3.0 quality at the full 30 seconds, noticeably faster than Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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+Prime+Spark\u0026amp;title=Wan+3.0+Prime+Spark+%E2%80%94+image+to+video\u0026amp;description=Animate+an+image+with+**Wan+3.0+Prime+Spark**%3A+Wan+3.0+quality+at+the+full+30+seconds%2C+noticeably+faster%0Athan+Wan+3.0+Spark.+480p%2C+720p+or+1080p%2C+with+optional+\u0026amp;theme=0751c57ef6bcb47b6f12b009\u0026amp;signature=1ecf1418248097c5a2376183eb26524d1fba29d4837165087f6f7db4d1d31523\">\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/q-zQTJUHDH_Z9YpV/_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://docs.fiveapi.ai/api-reference/wan-3-0-prime-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-prime-spark/image-to-video.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fiveapi.ai/#organization\",\"name\":\"Five API\",\"url\":\"https://docs.fiveapi.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/i2v/sjmdsydOIQ8k9Qu8/logo/light.svg?fit=max\u0026auto=format\u0026n=sjmdsydOIQ8k9Qu8\u0026q=85\u0026s=ba568ffb395958bdd81aac9c770a69c0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fiveapi.ai#website\",\"name\":\"Five API\",\"url\":\"https://docs.fiveapi.ai\",\"publisher\":{\"@id\":\"https://docs.fiveapi.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/image-to-video#webpage\",\"url\":\"https://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/image-to-video\",\"name\":\"Wan 3.0 Prime Spark — image to video\",\"description\":\"Animate an image with Wan 3.0 Prime Spark: Wan 3.0 quality at the full 30 seconds, noticeably faster than Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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-11-03T08:31:27.973Z\",\"isPartOf\":{\"@id\":\"https://docs.fiveapi.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/image-to-video#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/image-to-video#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Wan 3.0 Prime Spark\",\"item\":\"https://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/text-to-video\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Wan 3.0 Prime Spark — image to video\",\"item\":\"https://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/image-to-video\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/image-to-video#apireference\",\"headline\":\"Wan 3.0 Prime Spark — image to video\",\"name\":\"Wan 3.0 Prime Spark — image to video\",\"description\":\"Animate an image with Wan 3.0 Prime Spark: Wan 3.0 quality at the full 30 seconds, noticeably faster than Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/image-to-video\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fiveapi.ai/api-reference/wan-3-0-prime-spark/image-to-video#webpage\"},\"dateModified\":\"2026-11-03T08:31:27.973Z\",\"publisher\":{\"@id\":\"https://docs.fiveapi.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fiveapi.ai#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","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","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","description":"Generate a video from a text prompt with **Wan 3.0 Prime Spark**: Wan 3.0 quality at the full 30 seconds,\nnoticeably faster than Wan 3.0 Spark. 480p, 720p or 1080p, with optional synchronized 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-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"},{"title":"Wan 3.0 Prime Spark — reference to video","description":"Generate a video from reference assets with **Wan 3.0 Prime Spark**: Wan 3.0 quality at the full 30 seconds,\nnoticeably faster than Wan 3.0 Spark, 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-prime-spark/reference-to-video","href":"/api-reference/wan-3-0-prime-spark/reference-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"}]}]}]},"basePath":"","title":"Wan 3.0 Prime Spark — image to video - Five API","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}