/v1/videos/generations returns a task_id immediately after submission. Generation time depends on duration and resolution, and is generally one to five minutes. Poll /v1/tasks/{task_id} for status.
The video endpoint currently supports only the grok-imagine-video model. Inference and billing use the special pricing for the Grok route.
Convert reference images to data:image/...;base64,... Data URLs first. Browser blob: URLs cannot be submitted directly; your server must read the binary data and encode it.
curl "https://api-direct.dimilinks.com/v1/videos/generations" \ -H "Authorization: Bearer $DIMILINKS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-imagine-video", "prompt": "Keep the person consistent while the camera makes one complete orbit around the subject", "seconds": "10", "size": "1280x720", "resolution_name": "720p", "preset": "normal", "input_reference": [ "data:image/png;base64,iVBORw0KGgo..." ] }'
The video endpoint also uses the OpenAI-style error wrapper. See Errors for common errors. If a 400 response reports a reference-image problem, verify that:
The reference image is PNG, JPEG, or WebP.
It uses a Data URL, not a blob: URL or regular HTTP URL.
Each reference image is smaller than 10 MB.
The request includes no more than seven reference images.
{"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/videos/grok-imagine-video/generation","slug":"/en/api-reference/videos/grok-imagine-video/generation","pageMetadata":{"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"},"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: \"Generate 6- to 20-second videos with grok-imagine-video from text or reference images.\"\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={a:`a`,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,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`/v1/videos/generations`}),` returns a `,_jsx(_components.code,{children:`task_id`}),` immediately after submission. Generation time depends on duration and resolution, and is generally one to five minutes. Poll `,_jsx(_components.a,{href:`/en/api-reference/videos/grok-imagine-video/tasks`,children:_jsx(_components.code,{children:`/v1/tasks/{task_id}`})}),` for status.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The video endpoint currently supports only the `,_jsx(_components.code,{children:`grok-imagine-video`}),` model. Inference and billing use the special pricing for the Grok route.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request-url`,children:`Request URL`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api-direct.dimilinks.com/v1/videos/generations`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Content-Type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer \u003cDIMILINKS_API_KEY>`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`text-to-video-example`,children:`Text-to-video example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,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:`11`,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/videos/generations\"`}),_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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"grok-imagine-video\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"A group of neon jellyfish drifting slowly through the deep sea in cinematic light\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"seconds\": \"6\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\": \"1280x720\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution_name\": \"720p\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"preset\": \"normal\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Successful response:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,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:`\"queued\"`})]}),`\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`,_jsxs(_components.p,{children:[`After receiving `,_jsx(_components.code,{children:`task_id`}),`, call `,_jsx(_components.a,{href:`/en/api-reference/videos/grok-imagine-video/tasks`,children:`Retrieve video task`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`reference-image-to-video-example`,children:`Reference-image-to-video example`}),`\n`,_jsxs(_components.p,{children:[`Convert reference images to `,_jsx(_components.code,{children:`data:image/...;base64,...`}),` Data URLs first. Browser `,_jsx(_components.code,{children:`blob:`}),` URLs cannot be submitted directly; your server must read the binary data and encode it.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,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:`14`,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/videos/generations\"`}),_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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"grok-imagine-video\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"Keep the person consistent while the camera makes one complete orbit around the subject\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"seconds\": \"10\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\": \"1280x720\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution_name\": \"720p\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"preset\": \"normal\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"input_reference\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"data:image/png;base64,iVBORw0KGgo...\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`model`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Currently fixed to `,_jsx(_components.code,{children:`grok-imagine-video`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`prompt`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Video description, up to 2,500 characters.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`seconds`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Duration in seconds: `,_jsx(_components.code,{children:`\"6\"`}),` / `,_jsx(_components.code,{children:`\"10\"`}),` / `,_jsx(_components.code,{children:`\"12\"`}),` / `,_jsx(_components.code,{children:`\"16\"`}),` / `,_jsx(_components.code,{children:`\"20\"`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`size`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Frame size: `,_jsx(_components.code,{children:`1280x720`}),` (16:9), `,_jsx(_components.code,{children:`720x1280`}),` (9:16), or `,_jsx(_components.code,{children:`1024x1024`}),` (1:1).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resolution_name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Resolution tier: `,_jsx(_components.code,{children:`720p`}),` (HD) or `,_jsx(_components.code,{children:`480p`}),` (SD).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`preset`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Style preset: `,_jsx(_components.code,{children:`normal`}),` (standard), `,_jsx(_components.code,{children:`fun`}),` (high playfulness), `,_jsx(_components.code,{children:`spicy`}),` (high intensity), or `,_jsx(_components.code,{children:`custom`}),` (custom prompt).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`input_reference`})}),_jsx(_components.td,{children:`string[]`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Array of up to seven reference-image Data URLs. When provided, enables reference-image-to-video mode.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`group`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Route group. Console requests include `,_jsx(_components.code,{children:`default`}),`; third-party callers generally leave it empty.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`duration-and-resolution-combinations`,children:`Duration and resolution combinations`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`720p`}),` for final output. `,_jsx(_components.code,{children:`480p`}),` generates faster and is suitable for previews.`]}),`\n`,_jsxs(_components.li,{children:[`Longer durations increase generation time and price. Start with `,_jsx(_components.code,{children:`seconds: \"6\"`}),` to validate the workflow.`]}),`\n`,_jsxs(_components.li,{children:[`When changing the same prompt to `,_jsx(_components.code,{children:`9:16`}),` or `,_jsx(_components.code,{children:`1:1`}),`, describe where the subject should appear in the frame to avoid cropping.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-handling`,children:`Error handling`}),`\n`,_jsxs(_components.p,{children:[`The video endpoint also uses the OpenAI-style `,_jsx(_components.code,{children:`error`}),` wrapper. See `,_jsx(_components.a,{href:`/en/api-reference/errors`,children:`Errors`}),` for common errors. If a `,_jsx(_components.code,{children:`400`}),` response reports a reference-image problem, verify that:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The reference image is PNG, JPEG, or WebP.`}),`\n`,_jsxs(_components.li,{children:[`It uses a Data URL, not a `,_jsx(_components.code,{children:`blob:`}),` URL or regular HTTP URL.`]}),`\n`,_jsx(_components.li,{children:`Each reference image is smaller than 10 MB.`}),`\n`,_jsx(_components.li,{children:`The request includes no more than seven reference images.`}),`\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":"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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request URL","slug":"request-url","depth":2,"children":[]},{"title":"Text-to-video example","slug":"text-to-video-example","depth":2,"children":[]},{"title":"Reference-image-to-video example","slug":"reference-image-to-video-example","depth":2,"children":[]},{"title":"Parameters","slug":"parameters","depth":2,"children":[]},{"title":"Duration and resolution combinations","slug":"duration-and-resolution-combinations","depth":2,"children":[]},{"title":"Error handling","slug":"error-handling","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Videos"],"summary":"Create video generation","operationId":"createVideoGeneration","requestBody":"e33ab3c2-11d2-4ae8-9c8f-92b26846fa0c","responses":{"200":"35bc639f-0428-4dc6-acff-bba1cc69cffa","400":"fa959143-8dfd-4195-80b2-66f07202021e","401":"0e72a3ee-d929-4e5d-862e-212a696bbc02","403":"5bea8c72-8c9e-46f2-959b-c956aeab6490","429":"c1e15adf-9ace-4e29-ada4-ba2908f1ca3a"},"method":"post","type":"path","servers":["2c29fdb7-b188-4759-ace9-c3868771a848"],"security":["1aeffa9f-8a31-4ae9-9508-6c88da44205c"],"path":"/videos/generations","baseUrlOptions":["https://api-direct.dimilinks.com/v1"],"title":"Create video generation","description":"Generate 6- to 20-second videos with grok-imagine-video from text or reference images.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","default":"grok-imagine-video","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"prompt":{"type":"string","maxLength":2500,"isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"seconds":{"type":"string","enum":["6","10","12","16","20"],"isRequired":true,"uniqueKey":"seconds","typeLabel":"enum\u003cstring>"},"size":{"type":"string","enum":["1280x720","720x1280","1024x1024"],"isRequired":true,"uniqueKey":"size","typeLabel":"enum\u003cstring>"},"resolution_name":{"type":"string","enum":["480p","720p"],"isRequired":true,"uniqueKey":"resolution_name","typeLabel":"enum\u003cstring>"},"preset":{"type":"string","enum":["normal","fun","spicy","custom"],"isRequired":true,"uniqueKey":"preset","typeLabel":"enum\u003cstring>"},"input_reference":{"type":"array","items":{"type":"string","description":"data:image/...;base64,... Data URL","uniqueKey":"input_reference.items.[INDEX]","typeLabel":"string"},"maxItems":7,"uniqueKey":"input_reference","typeLabel":"string[]"},"group":{"type":"string","uniqueKey":"group","typeLabel":"string"}},"required":["model","prompt","seconds","size","resolution_name","preset"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"grok-imagine-video","prompt":"\u003cstring>","input_reference":["\u003cstring>"],"group":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"35bc639f-0428-4dc6-acff-bba1cc69cffa":{"description":"Video task submission","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","example":"video_xxx","uniqueKey":"data.id","typeLabel":"string"},"task_id":{"type":"string","example":"video_xxx","uniqueKey":"data.task_id","typeLabel":"string"},"status":{"type":"string","enum":["queued","pending","submitted"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"video_xxx","task_id":"video_xxx","status":"queued"}}}},"exampleType":"generated"}},"exampleType":"generated"},"fa959143-8dfd-4195-80b2-66f07202021e":{"description":"Invalid request","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"},"0e72a3ee-d929-4e5d-862e-212a696bbc02":{"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"},"5bea8c72-8c9e-46f2-959b-c956aeab6490":{"description":"Model is not allowed for this 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"},"c1e15adf-9ace-4e29-ada4-ba2908f1ca3a":{"description":"Rate limit exceeded","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":"Create video generation - DimiLinks API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"cn":{"href":"/api-reference/videos/grok-imagine-video/generation","matchLevel":1},"en":{"href":"/en/api-reference/videos/grok-imagine-video/generation","matchLevel":0},"jp":{"href":"/jp/api-reference/videos/grok-imagine-video/generation","matchLevel":1}}},"lastModified":"2026-08-21T03:33:17.020Z","originalFileLocation":"en/api-reference/videos/grok-imagine-video/generation.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=\"Generate 6- to 20-second videos with grok-imagine-video from text or reference images.\">\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=\"Create video generation - DimiLinks API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate 6- to 20-second videos with grok-imagine-video from text or reference images.\">\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/generation\">\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=Create+video+generation\u0026amp;description=Generate+6-+to+20-second+videos+with+grok-imagine-video+from+text+or+reference+images.\u0026amp;theme=b7e2bb269bbc94669c8f53d3\u0026amp;signature=061fe064a36aa82e273d7d01a2897c02e0cc27748c62d622828c84571dc4b748\">\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=\"Create video generation - DimiLinks API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate 6- to 20-second videos with grok-imagine-video from text or reference images.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dimilinks.mintlify.app/_mintlify/api/og/v2?division=Video+%2F+grok-imagine-video\u0026amp;title=Create+video+generation\u0026amp;description=Generate+6-+to+20-second+videos+with+grok-imagine-video+from+text+or+reference+images.\u0026amp;theme=b7e2bb269bbc94669c8f53d3\u0026amp;signature=061fe064a36aa82e273d7d01a2897c02e0cc27748c62d622828c84571dc4b748\">\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/generation\">\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/generation.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.dimilinks.com/api-reference/videos/grok-imagine-video/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.dimilinks.com/jp/api-reference/videos/grok-imagine-video/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.dimilinks.com/api-reference/videos/grok-imagine-video/generation\">\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/generation#webpage\",\"url\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation\",\"name\":\"Create video generation\",\"description\":\"Generate 6- to 20-second videos with grok-imagine-video from text or reference images.\",\"dateModified\":\"2026-08-21T03:33:17.020Z\",\"isPartOf\":{\"@id\":\"https://docs.dimilinks.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"DimiLinks API\",\"item\":\"https://docs.dimilinks.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create video generation\",\"item\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation#apireference\",\"headline\":\"Create video generation\",\"name\":\"Create video generation\",\"description\":\"Generate 6- to 20-second videos with grok-imagine-video from text or reference images.\",\"url\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dimilinks.com/en/api-reference/videos/grok-imagine-video/generation#webpage\"},\"dateModified\":\"2026-08-21T03:33:17.020Z\",\"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/generation"}]},{"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","description":"Poll the unified video task status and download the finished video.","openapi":"GET /videos/{task_id}","icon":"clock","href":"/en/api-reference/videos/tasks"}]},{"group":"Video / grok-imagine-video","pages":[{"title":"Create video generation","openapi":"POST /videos/generations","icon":"film","href":"/en/api-reference/videos/grok-imagine-video/generation"},{"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"}]},{"group":"IDE and CLI integrations","pages":[{"title":"One-click import into CC Switch / 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/generation"}]}]},"title":"Create video generation - 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"]}