If your product displays videos to end users, proxy this download through your server: use the key to retrieve the video, then deliver it under your own authentication so the DimiLinks key is never exposed to the browser.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DimiLinks API","colors":{"primary":"#10B981","light":"#34D399","dark":"#059669"},"logo":{"light":"https://mintcdn.com/dimilinks/Q9_PMAWcY1CQAY-u/logo/light.svg?fit=max\u0026auto=format\u0026n=Q9_PMAWcY1CQAY-u\u0026q=85\u0026s=fbfe5d159491af77f71b53dce63cecf9","dark":"https://mintcdn.com/dimilinks/Q9_PMAWcY1CQAY-u/logo/dark.svg?fit=max\u0026auto=format\u0026n=Q9_PMAWcY1CQAY-u\u0026q=85\u0026s=a181b25b848e37947025fa06d9f39099"},"favicon":"https://mintcdn.com/dimilinks/Q9_PMAWcY1CQAY-u/favicon.svg?fit=max\u0026auto=format\u0026n=Q9_PMAWcY1CQAY-u\u0026q=85\u0026s=595c2321ffdaf0e642c42c27e31617e9","footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"cn","navbar":{"links":[{"href":"https://dimilinks.com","label":"主页"},{"href":"https://dimilinks.com/pricing","label":"价格"}],"primary":{"type":"button","label":"打开控制台","href":"https://dimilinks.com/console"}},"href":""},{"language":"en","navbar":{"links":[{"href":"https://dimilinks.com/en","label":"Home"},{"href":"https://dimilinks.com/en/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Open console","href":"https://dimilinks.com/console"}},"href":"en"},{"language":"jp","navbar":{"links":[{"href":"https://dimilinks.com/ja","label":"ホーム"},{"href":"https://dimilinks.com/ja/pricing","label":"料金"}],"primary":{"type":"button","label":"コンソールを開く","href":"https://dimilinks.com/console"}},"href":"jp"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dimilinks","hasAudioNarration":false,"actualSubdomain":"dimilinks","customDomains":["docs.dimilinks.com"],"gitSource":{"type":"github","owner":"abca12a","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa254c6e16a9b5f298b986a","collectionId":"ac2abd7e-4a33-4e29-b658-899dec1f3101","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa254c6e16a9b5f298b986a"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aa25627c7207f700ce730eb","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"cn","tag":"API Reference","count":24},{"language":"en","tag":"API Reference","count":24},{"language":"jp","tag":"API リファレンス","count":18},{"language":"cn","tag":"基础","count":6},{"language":"en","tag":"Basics","count":6},{"language":"jp","tag":"基本","count":6},{"language":"cn","tag":"图片 / gpt-image-2","count":4},{"language":"cn","tag":"IDE 与 CLI 接入","count":4},{"language":"cn","tag":"视频 / 统一视频 API","count":4},{"language":"en","tag":"Images / gpt-image-2","count":4},{"language":"en","tag":"IDE and CLI integrations","count":4},{"language":"en","tag":"Videos / unified video API","count":4},{"language":"jp","tag":"画像 / gpt-image-2","count":4},{"language":"jp","tag":"IDE / CLI 連携","count":4},{"language":"cn","tag":"对话 / Chat","count":2},{"language":"cn","tag":"图片 / 更多模型","count":2},{"language":"cn","tag":"视频 / grok-imagine-video","count":2},{"language":"cn","tag":"指南","count":2},{"language":"cn","tag":"开始使用","count":2},{"language":"en","tag":"Chat","count":2},{"language":"en","tag":"Images / more models","count":2},{"language":"en","tag":"Video / grok-imagine-video","count":2},{"language":"en","tag":"Guides","count":2},{"language":"en","tag":"Get started","count":2},{"language":"jp","tag":"チャット","count":2},{"language":"jp","tag":"動画 / grok-imagine-video","count":2},{"language":"jp","tag":"ガイド","count":2},{"language":"jp","tag":"はじめに","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/videos/grok-imagine-video/tasks","slug":"/en/api-reference/videos/grok-imagine-video/tasks","pageMetadata":{"title":"Retrieve video task","description":"Retrieve the status and result URL of a video generation task.","openapi":"GET /tasks/{task_id}","icon":"bars-progress","href":"/en/api-reference/videos/grok-imagine-video/tasks"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve the status and result URL of a video generation task.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Video and image tasks share `,_jsx(_components.code,{children:`/v1/tasks/{task_id}`}),`. After submitting `,_jsx(_components.code,{children:`/v1/videos/generations`}),`, retrieve the returned `,_jsx(_components.code,{children:`task_id`}),` and poll this endpoint.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api-direct.dimilinks.com/v1/tasks/video_xxx\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$DIMILINKS_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`in-progress-response`,children:`In-progress response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"video_xxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"video_xxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"processing\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`35`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1777080000`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`successful-response`,children:`Successful response`}),`\n`,_jsxs(_components.p,{children:[`After the task reaches `,_jsx(_components.code,{children:`completed`}),`, retrieve the resulting video from `,_jsx(_components.code,{children:`/v1/videos/{task_id}/content`}),` with Bearer authentication.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"video_xxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"video_xxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"completed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1777080000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1777080300`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -L`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api-direct.dimilinks.com/v1/videos/video_xxx/content\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$DIMILINKS_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -o`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` video.mp4`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`If your product displays videos to end users, proxy this download through your server: use the key to retrieve the video, then deliver it under your own authentication so the DimiLinks key is never exposed to the browser.`}),`\n`,_jsx(Heading,{level:`2`,id:`failed-response`,children:`Failed response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"video_xxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"video_xxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1777080000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1777080300`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"upstream_error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Video generation failed. Please try again later.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`status-values`,children:`Status values`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`Recommended caller action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`queued`}),`, `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`submitted`})]}),_jsx(_components.td,{children:`Waiting to be processed`}),_jsx(_components.td,{children:`Continue polling`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`processing`}),`, `,_jsx(_components.code,{children:`in_progress`}),`, `,_jsx(_components.code,{children:`running`})]}),_jsx(_components.td,{children:`Generating`}),_jsx(_components.td,{children:`Continue polling`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`completed`}),`, `,_jsx(_components.code,{children:`success`})]}),_jsx(_components.td,{children:`Completed`}),_jsxs(_components.td,{children:[`Retrieve `,_jsx(_components.code,{children:`/v1/videos/{task_id}/content`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`error`}),`, `,_jsx(_components.code,{children:`cancelled`})]}),_jsx(_components.td,{children:`Failed`}),_jsx(_components.td,{children:`Display the error and allow the user to retry`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`polling-recommendations`,children:`Polling recommendations`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Poll every three to five seconds, slightly less frequently than for image tasks.`}),`\n`,_jsx(_components.li,{children:`Poll an individual task for at most ten minutes. After the timeout, tell the user the task failed and allow a retry.`}),`\n`,_jsxs(_components.li,{children:[`Stop polling immediately on `,_jsx(_components.code,{children:`404`}),`; the task ID is probably incorrect or does not belong to the current key.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retrieve video task","description":"Retrieve the status and result URL of a video generation task.","openapi":"GET /tasks/{task_id}","icon":"bars-progress","href":"/en/api-reference/videos/grok-imagine-video/tasks"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"In-progress response","slug":"in-progress-response","depth":2,"children":[]},{"title":"Successful response","slug":"successful-response","depth":2,"children":[]},{"title":"Failed response","slug":"failed-response","depth":2,"children":[]},{"title":"Status values","slug":"status-values","depth":2,"children":[]},{"title":"Polling recommendations","slug":"polling-recommendations","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Tasks"],"summary":"Retrieve task","description":"Retrieve the status and result URL of a video generation task.","operationId":"retrieveTask","parameters":["dde2d573-3757-4572-b052-7ca6fa0a2dd8"],"responses":{"200":"0134b8c1-0347-4d40-97b2-c1f8361d0fbf","401":"768bbca4-2a9e-4a9d-a6eb-a5f1f6cbe7cd","404":"50401f7f-2ce7-4e9e-965d-a6ac0b21eec0"},"method":"get","type":"path","servers":["2c29fdb7-b188-4759-ace9-c3868771a848"],"security":["1aeffa9f-8a31-4ae9-9508-6c88da44205c"],"path":"/tasks/{task_id}","baseUrlOptions":["https://api-direct.dimilinks.com/v1"],"title":"Retrieve task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dde2d573-3757-4572-b052-7ca6fa0a2dd8":{"name":"task_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"0134b8c1-0347-4d40-97b2-c1f8361d0fbf":{"description":"Image or video task","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["task_id","status","progress","created_at"],"properties":{"task_id":{"type":"string","example":"task_xxx","isRequired":true,"uniqueKey":"oneOf.0.task_id","typeLabel":"string"},"status":{"type":"string","enum":["NOT_START","SUBMITTED","QUEUED","IN_PROGRESS","SUCCESS","FAILURE"],"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"enum\u003cstring>"},"progress":{"type":"string","pattern":"^[0-9]{1,3}%$","example":"50%","isRequired":true,"uniqueKey":"oneOf.0.progress","typeLabel":"string"},"created_at":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.0.created_at","typeLabel":"integer"},"platform":{"type":"string","example":"openai","uniqueKey":"oneOf.0.platform","typeLabel":"string"},"fail_reason":{"type":"string","uniqueKey":"oneOf.0.fail_reason","typeLabel":"string"},"finished_at":{"type":"integer","uniqueKey":"oneOf.0.finished_at","typeLabel":"integer"},"data":{"type":"object","properties":{"created":{"type":"integer","uniqueKey":"oneOf.0.data.created","typeLabel":"integer"},"task_id":{"type":"string","example":"task_xxx","uniqueKey":"oneOf.0.data.task_id","typeLabel":"string"},"status":{"type":"string","example":"success","uniqueKey":"oneOf.0.data.status","typeLabel":"string"},"data":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","example":"https://lmage2.dimilinks.com/p/img/img_xxx/0?exp=1777166400000\u0026sig=...","uniqueKey":"oneOf.0.data.data.items.[INDEX].url","typeLabel":"string"},"file_id":{"type":"string","example":"file_xxx","uniqueKey":"oneOf.0.data.data.items.[INDEX].file_id","typeLabel":"string"}},"uniqueKey":"oneOf.0.data.data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.data.data","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"oneOf.0.data","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"oneOf.1.data.id","typeLabel":"string"},"task_id":{"type":"string","uniqueKey":"oneOf.1.data.task_id","typeLabel":"string"},"status":{"type":"string","enum":["queued","pending","submitted","processing","in_progress","running","completed","success","failed","error","cancelled"],"uniqueKey":"oneOf.1.data.status","typeLabel":"enum\u003cstring>"},"progress":{"type":"integer","minimum":0,"maximum":100,"uniqueKey":"oneOf.1.data.progress","typeLabel":"integer"},"created_at":{"type":"integer","uniqueKey":"oneOf.1.data.created_at","typeLabel":"integer"},"completed_at":{"type":"integer","uniqueKey":"oneOf.1.data.completed_at","typeLabel":"integer"},"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"oneOf.1.data.error.message","typeLabel":"string"},"type":{"type":"string","example":"invalid_request_error","uniqueKey":"oneOf.1.data.error.type","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"oneOf.1.data.error.code.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"oneOf.1.data.error.code.oneOf.1","typeLabel":"integer"}],"uniqueKey":"oneOf.1.data.error.code","typeLabel":"string | integer"}},"uniqueKey":"oneOf.1.data.error","typeLabel":"object"}},"uniqueKey":"oneOf.1.data","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"task_id":"task_xxx","status":"NOT_START","progress":"50%","created_at":123,"platform":"openai","fail_reason":"\u003cstring>","finished_at":123,"data":{"created":123,"task_id":"task_xxx","status":"success","data":[{"url":"https://lmage2.dimilinks.com/p/img/img_xxx/0?exp=1777166400000\u0026sig=...","file_id":"file_xxx"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"768bbca4-2a9e-4a9d-a6eb-a5f1f6cbe7cd":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"invalid_request_error","uniqueKey":"error.type","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"error.code.oneOf.1","typeLabel":"integer"}],"uniqueKey":"error.code","typeLabel":"string | integer"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"50401f7f-2ce7-4e9e-965d-a6ac0b21eec0":{"description":"Task not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"invalid_request_error","uniqueKey":"error.type","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"error.code.oneOf.1","typeLabel":"integer"}],"uniqueKey":"error.code","typeLabel":"string | integer"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1aeffa9f-8a31-4ae9-9508-6c88da44205c":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"2c29fdb7-b188-4759-ace9-c3868771a848":{"url":"https://api-direct.dimilinks.com/v1","description":"OpenAI 兼容入口:chat completions / images / videos / models / tasks"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"dimilinks","siteName":"DimiLinks API","title":"Retrieve video task - DimiLinks API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"cn":{"href":"/api-reference/videos/grok-imagine-video/tasks","matchLevel":1},"en":{"href":"/en/api-reference/videos/grok-imagine-video/tasks","matchLevel":0},"jp":{"href":"/jp/api-reference/videos/grok-imagine-video/tasks","matchLevel":1}}},"lastModified":"2026-08-21T03:33:17.051Z","originalFileLocation":"en/api-reference/videos/grok-imagine-video/tasks.mdx","locale":"en"},"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=\"Retrieve the status and result URL of a video generation task.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DimiLinks 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/dimilinks/K08tUZ6IquZnl6l7/_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/dimilinks/K08tUZ6IquZnl6l7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dimilinks/K08tUZ6IquZnl6l7/_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/dimilinks/K08tUZ6IquZnl6l7/_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/dimilinks/K08tUZ6IquZnl6l7/_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/dimilinks/K08tUZ6IquZnl6l7/_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/dimilinks/K08tUZ6IquZnl6l7/_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/dimilinks/K08tUZ6IquZnl6l7/_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/dimilinks/K08tUZ6IquZnl6l7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve video task - DimiLinks API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve the status and result URL of a video generation task.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DimiLinks API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dimilinks.mintlify.app/_mintlify/api/og/v2?division=Video+%2F+grok-imagine-video\u0026amp;title=Retrieve+video+task\u0026amp;description=Retrieve+the+status+and+result+URL+of+a+video+generation+task.\u0026amp;theme=b7e2bb269bbc94669c8f53d3\u0026amp;signature=bbcd715f95b231280b7ef7ae0ad068c64f70b532a6ffc3fae05386669a94c8be\">\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=\"Retrieve video task - DimiLinks API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve the status and result URL of a video generation task.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dimilinks.mintlify.app/_mintlify/api/og/v2?division=Video+%2F+grok-imagine-video\u0026amp;title=Retrieve+video+task\u0026amp;description=Retrieve+the+status+and+result+URL+of+a+video+generation+task.\u0026amp;theme=b7e2bb269bbc94669c8f53d3\u0026amp;signature=bbcd715f95b231280b7ef7ae0ad068c64f70b532a6ffc3fae05386669a94c8be\">\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/dimilinks/K08tUZ6IquZnl6l7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DimiLinks API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#10B981\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api-reference/videos/grok-imagine-video/tasks.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.dimilinks.com/api-reference/videos/grok-imagine-video/tasks\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.dimilinks.com/jp/api-reference/videos/grok-imagine-video/tasks\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.dimilinks.com/api-reference/videos/grok-imagine-video/tasks\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dimilinks.com/#organization\",\"name\":\"DimiLinks API\",\"url\":\"https://docs.dimilinks.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dimilinks/Q9_PMAWcY1CQAY-u/logo/light.svg?fit=max\u0026auto=format\u0026n=Q9_PMAWcY1CQAY-u\u0026q=85\u0026s=fbfe5d159491af77f71b53dce63cecf9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dimilinks.com#website\",\"name\":\"DimiLinks API\",\"url\":\"https://docs.dimilinks.com\",\"publisher\":{\"@id\":\"https://docs.dimilinks.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks#webpage\",\"url\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks\",\"name\":\"Retrieve video task\",\"description\":\"Retrieve the status and result URL of a video generation task.\",\"dateModified\":\"2026-08-21T03:33:17.051Z\",\"isPartOf\":{\"@id\":\"https://docs.dimilinks.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Video / grok-imagine-video\",\"item\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve video task\",\"item\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks#apireference\",\"headline\":\"Retrieve video task\",\"name\":\"Retrieve video task\",\"description\":\"Retrieve the status and result URL of a video generation task.\",\"url\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/tasks#webpage\"},\"dateModified\":\"2026-08-21T03:33:17.051Z\",\"publisher\":{\"@id\":\"https://docs.dimilinks.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dimilinks.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DimiLinks API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DimiLinks API","nav":{"global":null,"languages":[{"language":"cn","navbar":{"links":[{"href":"https://dimilinks.com","label":"主页"},{"href":"https://dimilinks.com/pricing","label":"价格"}],"primary":{"type":"button","label":"打开控制台","href":"https://dimilinks.com/console"}},"pages":[{"title":"cn","href":"/api-reference/videos/grok-imagine-video/tasks"}]},{"language":"en","navbar":{"links":[{"href":"https://dimilinks.com/en","label":"Home"},{"href":"https://dimilinks.com/en/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Open console","href":"https://dimilinks.com/console"}},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/en"}]},{"tab":"API Reference","groups":[{"group":"Basics","pages":[{"title":"API reference","icon":"terminal","href":"/en/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/en/api-reference/authentication"},{"title":"List models","openapi":"GET /models","icon":"boxes-stacked","href":"/en/api-reference/models"},{"title":"Model selection and updates","icon":"wand-magic-sparkles","href":"/en/api-reference/model-guide"},{"title":"Model groups \u0026 pricing","icon":"scale-balanced","href":"/en/api-reference/groups-and-pricing"},{"title":"Errors","icon":"circle-exclamation","href":"/en/api-reference/errors"}]},{"group":"Chat","pages":[{"title":"Create chat completion","openapi":"POST /chat/completions","icon":"message","href":"/en/api-reference/chat/completions"},{"title":"Anthropic Messages","openapi":"POST /messages","icon":"brain","href":"/en/api-reference/chat/anthropic-messages"}]},{"group":"Images / gpt-image-2","pages":[{"title":"Create image generation","openapi":"POST /images/generations","icon":"image","href":"/en/api-reference/images/gpt-image-2/generation"},{"title":"Create image edit","openapi":"POST /images/edits","icon":"wand-magic-sparkles","href":"/en/api-reference/images/gpt-image-2/edits"},{"title":"Retrieve image task","openapi":"GET /tasks/{task_id}","icon":"bars-progress","href":"/en/api-reference/images/gpt-image-2/tasks"},{"title":"Sizes and resolution","icon":"expand","href":"/en/api-reference/images/gpt-image-2/sizes"}]},{"group":"Images / more models","pages":[{"title":"Create image generation (Nano Banana Pro)","openapi":"POST /images/generations","icon":"image","href":"/en/api-reference/images/nano-banana-pro/generation"},{"title":"Create image generation (GPT Image 2.5)","openapi":"POST /images/generations","icon":"image","href":"/en/api-reference/images/gpt-image-2.5/generation"}]},{"group":"Videos / unified video API","pages":[{"title":"Video groups and billing rules","icon":"layer-group","href":"/en/api-reference/videos/groups"},{"title":"Create video generation (MiniMax-H3)","openapi":"POST /videos","icon":"film","href":"/en/api-reference/videos/minimax-h3/generation"},{"title":"Create video generation (Seedance 2.0 / 2.5)","openapi":"POST /videos","icon":"film","href":"/en/api-reference/videos/seedance/generation"},{"title":"Retrieve video task","openapi":"GET /videos/{task_id}","icon":"clock","href":"/en/api-reference/videos/tasks"}]},{"group":"Video / grok-imagine-video","pages":[{"title":"Create video generation","description":"Generate 6- to 20-second videos with grok-imagine-video from text or reference images.","openapi":"POST /videos/generations","icon":"film","href":"/en/api-reference/videos/grok-imagine-video/generation"},{"title":"Retrieve video task","openapi":"GET /tasks/{task_id}","icon":"bars-progress","href":"/en/api-reference/videos/grok-imagine-video/tasks"}]},{"group":"IDE and CLI integrations","pages":[{"title":"One-click import into CC Switch / Cherry Studio","description":"Send a key directly from the DimiLinks console to CC Switch or Cherry Studio.","icon":"share-from-square","href":"/en/api-reference/integrations/ccswitch"},{"title":"Claude Code integration","icon":"robot","href":"/en/api-reference/integrations/claude-code"},{"title":"Codex CLI integration","icon":"terminal","href":"/en/api-reference/integrations/codex-cli"},{"title":"VS Code and other IDEs","icon":"code","href":"/en/api-reference/integrations/vscode-and-ides"}]}]}]},{"language":"jp","navbar":{"links":[{"href":"https://dimilinks.com/ja","label":"ホーム"},{"href":"https://dimilinks.com/ja/pricing","label":"料金"}],"primary":{"type":"button","label":"コンソールを開く","href":"https://dimilinks.com/console"}},"pages":[{"title":"jp","href":"/jp/api-reference/videos/grok-imagine-video/tasks"}]}]},"title":"Retrieve video task - DimiLinks API","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}