Animate an image with Video Fast 1.0: 480p or 768p, 3–15 seconds. aspect_ratio: adaptive (the
default) keeps the shape of your image.
The image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio
between 0.4 and 2.5, at most 30 MB. See Input files and the
Image to video guide.
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/video-fast-1-0/image-to-video","slug":"/api-reference/video-fast-1-0/image-to-video","pageMetadata":{"title":"Video Fast 1.0 — image to video","description":"Animate an image with **Video Fast 1.0**: 480p or 768p, 3–15 seconds. `aspect_ratio: adaptive` (the\ndefault) keeps the shape of your image.\n\nThe image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio\nbetween 0.4 and 2.5, at most 30 MB. See [Input files](/concepts/input-files) and the\n[Image to video](/guides/image-to-video) guide.\n","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","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: \"Video Fast 1.0\"\n }), \": 480p or 768p, 3–15 seconds. \", _jsx(_components.code, {\n children: \"aspect_ratio: adaptive\"\n }), \" (the\\ndefault) keeps the shape of your image.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio\\nbetween 0.4 and 2.5, at most 30 MB. See \", _jsx(_components.a, {\n href: \"/concepts/input-files\",\n children: \"Input files\"\n }), \" and the\\n\", _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":"Video Fast 1.0 — image to video","description":"Animate an image with **Video Fast 1.0**: 480p or 768p, 3–15 seconds. `aspect_ratio: adaptive` (the\ndefault) keeps the shape of your image.\n\nThe image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio\nbetween 0.4 and 2.5, at most 30 MB. See [Input files](/concepts/input-files) and the\n[Image to video](/guides/image-to-video) guide.\n","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Video Fast 1.0"],"operationId":"videoFast10ImageToVideo","summary":"Video Fast 1.0 — image to video","x-mint":{"href":"/api-reference/video-fast-1-0/image-to-video","metadata":{"sidebarTitle":"Image to video"}},"description":"Animate an image with **Video Fast 1.0**: 480p or 768p, 3–15 seconds. `aspect_ratio: adaptive` (the\ndefault) keeps the shape of your image.\n\nThe image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio\nbetween 0.4 and 2.5, at most 30 MB. See [Input files](/concepts/input-files) and the\n[Image to video](/guides/image-to-video) guide.\n","parameters":["80f35792-9ef7-4254-b8df-7911266a1ee7"],"requestBody":"ddd26f38-db9d-4aef-9d94-e786257b654a","responses":{"200":"65d766b5-8622-489c-9b61-65d0891e7682","400":"9f67c074-5367-4b19-b083-ceeb00a342cc","401":"d0b1ad41-9685-4d32-b479-7f523b1d8953","402":"f109cb9f-d7f3-437a-9626-daea9499a3c6","403":"0b9c5b24-b4ea-41b1-99c7-e1d410c888f8","409":"f76a7a8f-972d-4a25-8e22-b2bfe357613d","429":"0f8a59d5-a5b8-431a-b658-1860edc2d69d","500":"9275214c-5d77-4774-80c1-f7064554c9c6","503":"e114fbc5-9d41-417e-8202-44b66db8171a"},"method":"post","type":"path","servers":["eb63f9b9-7090-4399-968a-974bbd0e3388"],"security":["aaefd599-c6ab-4048-ba85-e90f7c4b89c9"],"path":"/v1/video-fast/v1.0/image-to-video","baseUrlOptions":["https://api.fiveapi.ai"],"title":"Video Fast 1.0 — 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/portrait.jpg","body.duration":5,"body.resolution":"768p","body.prompt":"slow push-in, soft morning light, hair moving in the breeze","body.aspect_ratio":"adaptive","body.prompt_expansion":"advanced","body.webhook_url":"https://hooks.example.com/fiveapi","body.metadata":{"order_id":"ord_8812"}}]},"dependencies":{"parameters":{"80f35792-9ef7-4254-b8df-7911266a1ee7":{"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":"Video Fast 1.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. Shorter side at least 300 px, aspect ratio between 0.4 and 2.5, at most 30 MB.","examples":["https://assets.example.com/inputs/portrait.jpg"],"isRequired":true,"uniqueKey":"image_url","typeLabel":"string\u003curi>"},"duration":{"type":"integer","minimum":3,"maximum":15,"description":"Video length in seconds.","examples":[5],"isRequired":true,"uniqueKey":"duration","typeLabel":"integer"},"resolution":{"type":"string","enum":["480p","768p"],"description":"Output resolution.","examples":["768p"],"isRequired":true,"uniqueKey":"resolution","typeLabel":"enum\u003cstring>"},"prompt":{"type":"string","maxLength":2000,"description":"Optional. How to animate the image: motion, camera movement, mood.","examples":["slow push-in, soft morning light, hair moving in the breeze"],"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>"},"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":"Video Fast 1.0 image-to-video request · object"},"examples":{"basic":{"title":"basic","value":{"image_url":"https://assets.example.com/inputs/portrait.jpg","prompt":"slow push-in, soft morning light, hair moving in the breeze","duration":5,"resolution":"768p","aspect_ratio":"adaptive","prompt_expansion":"advanced","webhook_url":"https://hooks.example.com/fiveapi","metadata":{"order_id":"ord_8812"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"65d766b5-8622-489c-9b61-65d0891e7682":{"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_01J9X7Z0K7Q8W3F2P1N6M5V4R3","object":"task","model":"video-fast/v1.0/image-to-video","task":"image-to-video","status":"queued","input":{"image_url":"https://assets.example.com/inputs/portrait.jpg","prompt":"slow push-in, soft morning light, hair moving in the breeze","duration":5,"resolution":"768p","aspect_ratio":"adaptive","prompt_expansion":"advanced"},"error":null,"credits":{"estimated":14},"queue":{"position":3},"webhook_url":"https://hooks.example.com/fiveapi","metadata":{"order_id":"ord_8812"},"created_at":"2026-10-23T06:21:02.127Z"},"examples":{"Example":{"title":"Example","value":{"id":"task_01J9X7Z0K7Q8W3F2P1N6M5V4R3","object":"task","model":"video-fast/v1.0/image-to-video","task":"image-to-video","status":"queued","input":{"image_url":"https://assets.example.com/inputs/portrait.jpg","prompt":"slow push-in, soft morning light, hair moving in the breeze","duration":5,"resolution":"768p","aspect_ratio":"adaptive","prompt_expansion":"advanced"},"error":null,"credits":{"estimated":14},"queue":{"position":3},"webhook_url":"https://hooks.example.com/fiveapi","metadata":{"order_id":"ord_8812"},"created_at":"2026-10-23T06:21:02.127Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"9f67c074-5367-4b19-b083-ceeb00a342cc":{"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"},"d0b1ad41-9685-4d32-b479-7f523b1d8953":{"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"},"f109cb9f-d7f3-437a-9626-daea9499a3c6":{"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"},"0b9c5b24-b4ea-41b1-99c7-e1d410c888f8":{"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"},"f76a7a8f-972d-4a25-8e22-b2bfe357613d":{"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"},"0f8a59d5-a5b8-431a-b658-1860edc2d69d":{"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"},"9275214c-5d77-4774-80c1-f7064554c9c6":{"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"},"e114fbc5-9d41-417e-8202-44b66db8171a":{"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":"Video Fast 1.0 — image to video - Five API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T12:09:50.767Z","originalFileLocation":"api-reference/video-fast-1-0/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 Video Fast 1.0: 480p or 768p, 3–15 seconds. aspect_ratio: adaptive (the default) keeps the shape of your image. The image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio between 0.4 and 2.5, at most 30 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=\"Video Fast 1.0 — image to video - Five API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Animate an image with Video Fast 1.0: 480p or 768p, 3–15 seconds. aspect_ratio: adaptive (the default) keeps the shape of your image. The image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio between 0.4 and 2.5, at most 30 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/video-fast-1-0/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=Video+Fast+1.0\u0026amp;title=Video+Fast+1.0+%E2%80%94+image+to+video\u0026amp;description=Animate+an+image+with+**Video+Fast+1.0**%3A+480p+or+768p%2C+3%E2%80%9315+seconds.+%60aspect_ratio%3A+adaptive%60+%28the%0Adefault%29+keeps+the+shape+of+your+image.%0A%0AThe+image+must+be+a\u0026amp;theme=9d2dc752b2506fd259767f0d\u0026amp;signature=b751982ae39ada90c994da31fcb48b407cc36b637aa6b5c43982d07f49b514c6\">\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=\"Video Fast 1.0 — image to video - Five API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Animate an image with Video Fast 1.0: 480p or 768p, 3–15 seconds. aspect_ratio: adaptive (the default) keeps the shape of your image. The image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio between 0.4 and 2.5, at most 30 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=Video+Fast+1.0\u0026amp;title=Video+Fast+1.0+%E2%80%94+image+to+video\u0026amp;description=Animate+an+image+with+**Video+Fast+1.0**%3A+480p+or+768p%2C+3%E2%80%9315+seconds.+%60aspect_ratio%3A+adaptive%60+%28the%0Adefault%29+keeps+the+shape+of+your+image.%0A%0AThe+image+must+be+a\u0026amp;theme=9d2dc752b2506fd259767f0d\u0026amp;signature=b751982ae39ada90c994da31fcb48b407cc36b637aa6b5c43982d07f49b514c6\">\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/video-fast-1-0/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/video-fast-1-0/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/video-fast-1-0/image-to-video#webpage\",\"url\":\"https://testweb2-docs-openapi.test765.com/api-reference/video-fast-1-0/image-to-video\",\"name\":\"Video Fast 1.0 — image to video\",\"description\":\"Animate an image with Video Fast 1.0: 480p or 768p, 3–15 seconds. aspect_ratio: adaptive (the default) keeps the shape of your image. The image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio between 0.4 and 2.5, at most 30 MB. See Input files and the Image to video guide.\",\"dateModified\":\"2026-10-28T12:09:50.767Z\",\"isPartOf\":{\"@id\":\"https://testweb2-docs-openapi.test765.com#website\"},\"breadcrumb\":{\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/video-fast-1-0/image-to-video#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/video-fast-1-0/image-to-video#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Video Fast 1.0\",\"item\":\"https://testweb2-docs-openapi.test765.com/api-reference/video-fast-1-0/text-to-video\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Video Fast 1.0 — image to video\",\"item\":\"https://testweb2-docs-openapi.test765.com/api-reference/video-fast-1-0/image-to-video\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/video-fast-1-0/image-to-video#apireference\",\"headline\":\"Video Fast 1.0 — image to video\",\"name\":\"Video Fast 1.0 — image to video\",\"description\":\"Animate an image with Video Fast 1.0: 480p or 768p, 3–15 seconds. aspect_ratio: adaptive (the default) keeps the shape of your image. The image must be a public HTTPS URL of a JPG, PNG or WebP file: shorter side at least 300 px, aspect ratio between 0.4 and 2.5, at most 30 MB. See Input files and the Image to video guide.\",\"url\":\"https://testweb2-docs-openapi.test765.com/api-reference/video-fast-1-0/image-to-video\",\"mainEntityOfPage\":{\"@id\":\"https://testweb2-docs-openapi.test765.com/api-reference/video-fast-1-0/image-to-video#webpage\"},\"dateModified\":\"2026-10-28T12:09:50.767Z\",\"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","description":"Generate a video from a text prompt with **Video Fast 1.0**: fast, low-cost generation at 480p or 768p,\n3–15 seconds.\n\nThe call returns a `queued` task right away and holds `credits.estimated`. Get the video with a\n[webhook](/concepts/webhooks) or by polling [Get a task](/api-reference/tasks/get-task). Guide:\n[Text to video](/guides/text-to-video).\n","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","description":"Generate a video that keeps the look of your reference images, the motion of your reference videos and the\nsound of your reference audio, with **Video Fast 1.0**: 480p or 768p, 3–30 seconds.\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 9 | JPG, PNG or WebP, 256–5,760 px, at most 30 MB each |\n| `reference_videos` | up to 3 | 2–15 seconds and at most 50 MB each |\n| `reference_audios` | up to 3 | at most 15 MB each; send them together with an image or a video |\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/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","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":"Video Fast 1.0 — 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"]}