Returns the current state of a task: queued while it waits for a generation slot, processing while the
model runs, and once it is completed, output.video.url holds the MP4.
Poll every 5–10 seconds per task with backoff, or use webhooks instead: polls count
against the rate limit, 10 requests per second and 300 per minute for the whole
account on the standard plan. The output is removed at expires_at, 7 days after completion; the task
itself stays readable without output. A task of another account answers 404 task_not_found.
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/tasks/get-task","slug":"/api-reference/tasks/get-task","pageMetadata":{"title":"Get a task","description":"Returns the current state of a task: `queued` while it waits for a generation slot, `processing` while the\nmodel runs, and once it is `completed`, `output.video.url` holds the MP4.\n\nPoll every 5–10 seconds per task with backoff, or use [webhooks](/concepts/webhooks) instead: polls count\nagainst the [rate limit](/concepts/rate-limits), 10 requests per second and 300 per minute for the whole\naccount on the `standard` plan. The output is removed at `expires_at`, 7 days after completion; the task\nitself stays readable without `output`. A task of another account answers `404 task_not_found`.\n\n**Scope:** `video:read`.\n","deprecated":null,"version":null,"sidebarTitle":"Get task","openapi":"/api-reference/openapi.yaml get /v1/tasks/{task_id}","href":"/api-reference/tasks/get-task","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: [\"Returns the current state of a task: \", _jsx(_components.code, {\n children: \"queued\"\n }), \" while it waits for a generation slot, \", _jsx(_components.code, {\n children: \"processing\"\n }), \" while the\\nmodel runs, and once it is \", _jsx(_components.code, {\n children: \"completed\"\n }), \", \", _jsx(_components.code, {\n children: \"output.video.url\"\n }), \" holds the MP4.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Poll every 5–10 seconds per task with backoff, or use \", _jsx(_components.a, {\n href: \"/concepts/webhooks\",\n children: \"webhooks\"\n }), \" instead: polls count\\nagainst the \", _jsx(_components.a, {\n href: \"/concepts/rate-limits\",\n children: \"rate limit\"\n }), \", 10 requests per second and 300 per minute for the whole\\naccount on the \", _jsx(_components.code, {\n children: \"standard\"\n }), \" plan. The output is removed at \", _jsx(_components.code, {\n children: \"expires_at\"\n }), \", 7 days after completion; the task\\nitself stays readable without \", _jsx(_components.code, {\n children: \"output\"\n }), \". A task of another account answers \", _jsx(_components.code, {\n children: \"404 task_not_found\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Scope:\"\n }), \" \", _jsx(_components.code, {\n children: \"video:read\"\n }), \".\"]\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":"Get a task","description":"Returns the current state of a task: `queued` while it waits for a generation slot, `processing` while the\nmodel runs, and once it is `completed`, `output.video.url` holds the MP4.\n\nPoll every 5–10 seconds per task with backoff, or use [webhooks](/concepts/webhooks) instead: polls count\nagainst the [rate limit](/concepts/rate-limits), 10 requests per second and 300 per minute for the whole\naccount on the `standard` plan. The output is removed at `expires_at`, 7 days after completion; the task\nitself stays readable without `output`. A task of another account answers `404 task_not_found`.\n\n**Scope:** `video:read`.\n","deprecated":null,"version":null,"sidebarTitle":"Get task","openapi":"/api-reference/openapi.yaml get /v1/tasks/{task_id}","href":"/api-reference/tasks/get-task","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Tasks"],"operationId":"getTask","summary":"Get a task","x-mint":{"href":"/api-reference/tasks/get-task"},"description":"Returns the current state of a task: `queued` while it waits for a generation slot, `processing` while the\nmodel runs, and once it is `completed`, `output.video.url` holds the MP4.\n\nPoll every 5–10 seconds per task with backoff, or use [webhooks](/concepts/webhooks) instead: polls count\nagainst the [rate limit](/concepts/rate-limits), 10 requests per second and 300 per minute for the whole\naccount on the `standard` plan. The output is removed at `expires_at`, 7 days after completion; the task\nitself stays readable without `output`. A task of another account answers `404 task_not_found`.\n\n**Scope:** `video:read`.\n","parameters":["77e77b6e-72a3-4573-9d93-29688bc687c9"],"responses":{"200":"af969209-0abc-4556-af79-f4449eb48cc9","401":"5a08442e-b167-491b-98ce-75ce0e11e97f","403":"d5cae0d0-38b8-433d-a2ac-e54cfd1c95b0","404":"7cfe30fe-5acf-4452-961e-524d6b76c9b0","429":"53075153-73e8-42f1-bf61-e57e176d5dcf"},"method":"get","type":"path","servers":["0e5c1744-8f81-4abf-9952-ca188e3f192a"],"security":["284c627a-1d7c-49fc-865b-457e3dfc246f"],"path":"/v1/tasks/{task_id}","baseUrlOptions":["https://api.fiveapi.ai"],"title":"Get a task","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go","java","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"77e77b6e-72a3-4573-9d93-29688bc687c9":{"name":"task_id","in":"path","required":true,"description":"The task id (`task_` followed by 26 characters).","schema":{"type":"string","examples":["task_01J9X7Z0K7Q8W3F2P1N6M5V4R3"],"isRequired":true,"description":"The task id (`task_` followed by 26 characters).","uniqueKey":"","typeLabel":"string"}}},"responses":{"af969209-0abc-4556-af79-f4449eb48cc9":{"description":"The task.","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","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"},"examples":{"completed":{"title":"completed","value":{"id":"task_01J9X7Z0K7Q8W3F2P1N6M5V4R3","object":"task","model":"wan/v3.0-spark/image-to-video","task":"image-to-video","status":"completed","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":"720p","aspect_ratio":"adaptive"},"output":{"video":{"url":"https://openassets.fiveapi.ai/x2v/results/551fe9fa/Five_API_1793171336.mp4","content_type":"video/mp4","file_size":4823119,"width":720,"height":1280,"duration":5.04,"fps":24,"cover_url":"https://openassets.fiveapi.ai/x2v/results/61f69823/Five_API_1793171336.jpg"}},"error":null,"credits":{"estimated":60,"charged":60},"webhook_url":"https://hooks.example.com/fiveapi","metadata":{"order_id":"ord_8812"},"created_at":"2026-10-23T06:21:02.127Z","started_at":"2026-10-23T06:21:40.512Z","completed_at":"2026-10-23T06:23:05.004Z","expires_at":"2026-10-30T06:23:05.004Z"}},"queued":{"title":"queued","value":{"id":"task_01J9X7Z0K7Q8W3F2P1N6M5V4R3","object":"task","model":"wan/v3.0-spark/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":"720p","aspect_ratio":"adaptive"},"error":null,"credits":{"estimated":60},"webhook_url":"https://hooks.example.com/fiveapi","metadata":{"order_id":"ord_8812"},"created_at":"2026-10-23T06:21:02.127Z"}},"processing":{"title":"processing","value":{"id":"task_01J9X7Z0K7Q8W3F2P1N6M5V4R3","object":"task","model":"wan/v3.0-spark/image-to-video","task":"image-to-video","status":"processing","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":"720p","aspect_ratio":"adaptive"},"error":null,"credits":{"estimated":60},"webhook_url":"https://hooks.example.com/fiveapi","metadata":{"order_id":"ord_8812"},"created_at":"2026-10-23T06:21:02.127Z","started_at":"2026-10-23T06:21:40.512Z"}},"failed":{"title":"failed","value":{"id":"task_01J9X8A1B2C3D4E5F6G7H8J9K0","object":"task","model":"video-fast/v1.0/text-to-video","task":"text-to-video","status":"failed","input":{"prompt":"a red kite rising over a windy beach at sunset","duration":5,"resolution":"480p"},"error":{"code":"generation_failed","message":"the model failed to produce a result","retryable":true},"credits":{"estimated":9},"created_at":"2026-10-23T06:25:11.000Z","started_at":"2026-10-23T06:25:12.200Z","completed_at":"2026-10-23T06:25:14.318Z"}},"cancelled":{"title":"cancelled","value":{"id":"task_01J9X9C2D3E4F5G6H7J8K9L0M1","object":"task","model":"wan/v3.0-prime-spark/text-to-video","task":"text-to-video","status":"cancelled","input":{"prompt":"macro shot of rain drops hitting a leaf, slow motion","duration":4,"resolution":"720p","aspect_ratio":"9:16"},"error":null,"credits":{"estimated":64},"created_at":"2026-10-23T06:30:00.000Z","completed_at":"2026-10-23T06:30:21.450Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"5a08442e-b167-491b-98ce-75ce0e11e97f":{"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"},"d5cae0d0-38b8-433d-a2ac-e54cfd1c95b0":{"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"},"7cfe30fe-5acf-4452-961e-524d6b76c9b0":{"description":"Unknown model or task (`model_not_found`, `task_not_found`). A task of another account is also a `404`.","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_not_found":{"title":"task_not_found","value":{"error":{"type":"not_found_error","code":"task_not_found","message":"no such task: task_01ZZZZZZZZZZZZZZZZZZZZZZZZ","request_id":"req_01M5KN36WF28NP71BQ6AJ47Q8Y"}}},"model_not_found":{"title":"model_not_found","value":{"error":{"type":"not_found_error","code":"model_not_found","message":"no such model: nobrand/v9/text-to-video","param":"model","request_id":"req_01M5KN36QQXYGKNTNVM7WGQPD0"}}}},"exampleType":"examples"}},"exampleType":"examples"},"53075153-73e8-42f1-bf61-e57e176d5dcf":{"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"}},"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":"Get a task - Five API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T08:31:28.017Z","originalFileLocation":"api-reference/tasks/get-task.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=\"Returns the current state of a task: queued while it waits for a generation slot, processing while the model runs, and once it is completed, output.video.url holds the MP4. Poll every 5–10 seconds per task with backoff, or use webhooks instead: polls count against the rate limit, 10 requests per second and 300 per minute for the whole account on the standard plan. The output is removed at expires_at, 7 days after completion; the task itself stays readable without output. A task of another account answers 404 task_not_found. Scope: video:read.\">\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=\"Get a task - Five API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the current state of a task: queued while it waits for a generation slot, processing while the model runs, and once it is completed, output.video.url holds the MP4. Poll every 5–10 seconds per task with backoff, or use webhooks instead: polls count against the rate limit, 10 requests per second and 300 per minute for the whole account on the standard plan. The output is removed at expires_at, 7 days after completion; the task itself stays readable without output. A task of another account answers 404 task_not_found. Scope: video:read.\">\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/tasks/get-task\">\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=Tasks\u0026amp;title=Get+a+task\u0026amp;description=Returns+the+current+state+of+a+task%3A+%60queued%60+while+it+waits+for+a+generation+slot%2C+%60processing%60+while+the%0Amodel+runs%2C+and+once+it+is+%60completed%60%2C+%60output.video\u0026amp;theme=0751c57ef6bcb47b6f12b009\u0026amp;signature=fac5191c5882215fb7c84a38f27e805192506c75424e1de43d7bcd60ff94ab8a\">\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=\"Get a task - Five API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the current state of a task: queued while it waits for a generation slot, processing while the model runs, and once it is completed, output.video.url holds the MP4. Poll every 5–10 seconds per task with backoff, or use webhooks instead: polls count against the rate limit, 10 requests per second and 300 per minute for the whole account on the standard plan. The output is removed at expires_at, 7 days after completion; the task itself stays readable without output. A task of another account answers 404 task_not_found. Scope: video:read.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://i2v.mintlify.app/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Get+a+task\u0026amp;description=Returns+the+current+state+of+a+task%3A+%60queued%60+while+it+waits+for+a+generation+slot%2C+%60processing%60+while+the%0Amodel+runs%2C+and+once+it+is+%60completed%60%2C+%60output.video\u0026amp;theme=0751c57ef6bcb47b6f12b009\u0026amp;signature=fac5191c5882215fb7c84a38f27e805192506c75424e1de43d7bcd60ff94ab8a\">\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/tasks/get-task\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tasks/get-task.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/tasks/get-task#webpage\",\"url\":\"https://docs.fiveapi.ai/api-reference/tasks/get-task\",\"name\":\"Get a task\",\"description\":\"Returns the current state of a task: queued while it waits for a generation slot, processing while the model runs, and once it is completed, output.video.url holds the MP4. Poll every 5–10 seconds per task with backoff, or use webhooks instead: polls count against the rate limit, 10 requests per second and 300 per minute for the whole account on the standard plan. The output is removed at expires_at, 7 days after completion; the task itself stays readable without output. A task of another account answers 404 task_not_found. Scope: video:read.\",\"dateModified\":\"2026-11-03T08:31:28.017Z\",\"isPartOf\":{\"@id\":\"https://docs.fiveapi.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fiveapi.ai/api-reference/tasks/get-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fiveapi.ai/api-reference/tasks/get-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Five API\",\"item\":\"https://docs.fiveapi.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a task\",\"item\":\"https://docs.fiveapi.ai/api-reference/tasks/get-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fiveapi.ai/api-reference/tasks/get-task#apireference\",\"headline\":\"Get a task\",\"name\":\"Get a task\",\"description\":\"Returns the current state of a task: queued while it waits for a generation slot, processing while the model runs, and once it is completed, output.video.url holds the MP4. Poll every 5–10 seconds per task with backoff, or use webhooks instead: polls count against the rate limit, 10 requests per second and 300 per minute for the whole account on the standard plan. The output is removed at expires_at, 7 days after completion; the task itself stays readable without output. A task of another account answers 404 task_not_found. Scope: video:read.\",\"url\":\"https://docs.fiveapi.ai/api-reference/tasks/get-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fiveapi.ai/api-reference/tasks/get-task#webpage\"},\"dateModified\":\"2026-11-03T08:31:28.017Z\",\"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","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","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","description":"Continue an existing clip with **Video Fast Extend 1.1**, with matched audio when `generate_audio` is\ntrue. 480p, 720p or 1080p.\n\n`duration` is the number of seconds **added** after the clip (3–30). The clip, after the optional\n`start_time` / `end_time` window (send both or neither), must be 2–30 seconds long, and clip plus added\nseconds may not exceed 30 seconds. The result is the clip followed by the continuation, so\n`output.video.duration` is at least `duration`.\n\nThe clip must be a public HTTPS URL of an MP4 or MOV file, 360–2,000 px per side, at most 500 MB. Guide:\n[Video extend](/guides/video-extend).\n","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","description":"Lists the tasks of your account, across all of its API keys, newest first. Filter by `status`, `model` and\n`created_after`. To page, pass the `id` of the last task you received as `starting_after` while `has_more`\nis true. Requests rejected at submit time (for example with `402`) never become tasks and are not listed.\n\n**Scope:** `video:read`.\n","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":"Get a task - 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"]}