Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.
POST
/
api
/
v3
/
contents
/
generations
/
tasks
Create video task
curl --request POST \ --url https://api.omnirelay.ai/api/v3/contents/generations/tasks \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "doubao-seedance-2-0-260128", "content": [ { "type": "text", "text": "A paper boat drifting on a calm pond at sunrise, slow camera pan" } ]}'
import requests
url = "https://api.omnirelay.ai/api/v3/contents/generations/tasks"
payload = {
"model": "doubao-seedance-2-0-260128",
"content": [
{
"type": "text",
"text": "A paper boat drifting on a calm pond at sunrise, slow camera pan"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'doubao-seedance-2-0-260128',
content: [
{
type: 'text',
text: 'A paper boat drifting on a calm pond at sunrise, slow camera pan'
}
]
})
};
fetch('https://api.omnirelay.ai/api/v3/contents/generations/tasks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
Tags for this call as comma-separated key=value pairs, for example client=acme,env=prod. Merged with the API key's default tags; the tags body field wins on the same key. X-OmniRelay-Tags is the same header under its former name and stays accepted.
Task ID. Poll it with GET /api/v3/contents/generations/tasks/{id}.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OmniRelay Documentation","description":"One OpenAI-compatible API for every model: keys, routing, usage and billing in one gateway.","colors":{"primary":"#3155f5","light":"#7d95ff","dark":"#3155f5"},"logo":{"light":"https://mintcdn.com/mirvos/m9J_0EZqJ57fDiaC/logo.svg?fit=max\u0026auto=format\u0026n=m9J_0EZqJ57fDiaC\u0026q=85\u0026s=ca602e0318071154028ed8989c7110cc","dark":"https://mintcdn.com/mirvos/m9J_0EZqJ57fDiaC/logo.svg?fit=max\u0026auto=format\u0026n=m9J_0EZqJ57fDiaC\u0026q=85\u0026s=ca602e0318071154028ed8989c7110cc","href":"https://omnirelay.ai"},"favicon":"https://mintcdn.com/mirvos/m9J_0EZqJ57fDiaC/favicon.svg?fit=max\u0026auto=format\u0026n=m9J_0EZqJ57fDiaC\u0026q=85\u0026s=87700ecee580e455626d4376f120e405","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://omnirelay.ai","label":"Website"},{"href":"https://omnirelay.instatus.com","label":"Status"}],"primary":{"type":"button","label":"Open Console","href":"https://omnirelay.ai/login"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"cn","navbar":{"links":[{"href":"https://omnirelay.ai","label":"官网"},{"href":"https://omnirelay.instatus.com","label":"服务状态"}],"primary":{"type":"button","label":"打开控制台","href":"https://omnirelay.ai/login"}},"href":"cn"},{"language":"es","navbar":{"links":[{"href":"https://omnirelay.ai","label":"Sitio web"},{"href":"https://omnirelay.instatus.com","label":"Estado"}],"primary":{"type":"button","label":"Abrir consola","href":"https://omnirelay.ai/login"}},"href":"es/user-manual"},{"language":"fr","navbar":{"links":[{"href":"https://omnirelay.ai","label":"Site web"},{"href":"https://omnirelay.instatus.com","label":"État du service"}],"primary":{"type":"button","label":"Ouvrir la console","href":"https://omnirelay.ai/login"}},"href":"fr/user-manual"},{"language":"de","navbar":{"links":[{"href":"https://omnirelay.ai","label":"Website"},{"href":"https://omnirelay.instatus.com","label":"Dienststatus"}],"primary":{"type":"button","label":"Konsole öffnen","href":"https://omnirelay.ai/login"}},"href":"de/user-manual"},{"language":"pt-BR","navbar":{"links":[{"href":"https://omnirelay.ai","label":"Site"},{"href":"https://omnirelay.instatus.com","label":"Status"}],"primary":{"type":"button","label":"Abrir console","href":"https://omnirelay.ai/login"}},"href":"pt-BR/user-manual"},{"language":"jp","navbar":{"links":[{"href":"https://omnirelay.ai","label":"ウェブサイト"},{"href":"https://omnirelay.instatus.com","label":"サービス状況"}],"primary":{"type":"button","label":"コンソールを開く","href":"https://omnirelay.ai/login"}},"href":"jp/user-manual"},{"language":"ko","navbar":{"links":[{"href":"https://omnirelay.ai","label":"웹사이트"},{"href":"https://omnirelay.instatus.com","label":"서비스 상태"}],"primary":{"type":"button","label":"콘솔 열기","href":"https://omnirelay.ai/login"}},"href":"ko/user-manual"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mirvos","hasAudioNarration":false,"actualSubdomain":"mirvos","customDomains":["omnirelay.ai"],"gitSource":{"type":"github","owner":"mirvos-ai","repo":"omnirelay-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aea0b3298ee2cfbfea93cfe","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"cn","tag":"V1 文档","count":24},{"language":"en","tag":"V1 Documentation","count":24},{"language":"cn","tag":"V1 API 参考","count":18},{"language":"en","tag":"V1 API Reference","count":18},{"language":"cn","tag":"管理 API","count":9},{"language":"en","tag":"Management","count":9},{"language":"cn","tag":"通用","count":8},{"language":"en","tag":"General","count":8},{"language":"cn","tag":"LLM","count":4},{"language":"cn","tag":"视频","count":4},{"language":"en","tag":"LLMs","count":4},{"language":"en","tag":"Videos","count":4},{"language":"cn","tag":"图片","count":3},{"language":"cn","tag":"概览","count":3},{"language":"cn","tag":"快速开始","count":3},{"language":"de","tag":"V1-Dokumentation","count":3},{"language":"es","tag":"Documentación V1","count":3},{"language":"fr","tag":"Documentation V1","count":3},{"language":"en","tag":"Images","count":3},{"language":"en","tag":"Overview","count":3},{"language":"en","tag":"Quick Start","count":3},{"language":"jp","tag":"V1 ドキュメント","count":3},{"language":"ko","tag":"V1 문서","count":3},{"language":"pt-BR","tag":"Documentação V1","count":3},{"language":"de","tag":"Allgemein","count":2},{"language":"es","tag":"General","count":2},{"language":"fr","tag":"Général","count":2},{"language":"jp","tag":"一般","count":2},{"language":"ko","tag":"일반","count":2},{"language":"pt-BR","tag":"Geral","count":2},{"language":"cn","tag":"用户手册","count":1},{"language":"de","tag":"Benutzerhandbuch","count":1},{"language":"es","tag":"Manual de usuario","count":1},{"language":"fr","tag":"Guide utilisateur","count":1},{"language":"en","tag":"User manual","count":1},{"language":"jp","tag":"ユーザーマニュアル","count":1},{"language":"ko","tag":"사용자 매뉴얼","count":1},{"language":"pt-BR","tag":"Manual do usuário","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/videos/create-video-task","slug":"/api-reference/videos/create-video-task","pageMetadata":{"title":"Create video task","description":"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v3/contents/generations/tasks","href":"/api-reference/videos/create-video-task","autogeneratedByOpenApi":true},"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: \"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create video task","description":"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v3/contents/generations/tasks","href":"/api-reference/videos/create-video-task","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Videos"],"summary":"Create video task","operationId":"createVideoTask","description":"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.","parameters":["2d1d359f-2cf9-4c10-8414-0aac03e0027c"],"requestBody":"63092ff1-b3a2-48f0-8611-f2987d96daf2","responses":{"200":"f54cf515-afd5-47df-82ca-8ff4139de0d5","400":"0d534850-8754-4ac3-b7ec-fb97150ec567","401":"3a4c46c9-b119-4295-a364-882f6df3ac8f","402":"cc39dc6b-0cfe-455b-bd15-f6270ab8897a","403":"186c7ab9-3554-4e30-ac84-34b012789ba2","404":"95c85dec-97cd-4619-a958-109e7bed0add","413":"326fae90-e0f2-47a3-8b1b-183a3da2f1a4","429":"e1517588-4edd-403c-b91d-04b2c7b262bd","502":"ccb994bd-fb83-47c0-b097-b370895def06","503":"1a111ea1-9f7b-4e04-a5fa-e16201acfa99","504":"367934aa-7b9e-4d85-adad-3b7c44d643c9"},"method":"post","type":"path","servers":["8343319b-fc64-466b-b314-1aa49367d633"],"security":["0cfd7c8d-004d-4e0d-96de-988610dc14a3"],"path":"/api/v3/contents/generations/tasks","baseUrlOptions":["https://api.omnirelay.ai"],"title":"Create video task","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2d1d359f-2cf9-4c10-8414-0aac03e0027c":{"name":"X-Gateway-Tags","in":"header","required":false,"description":"Tags for this call as comma-separated `key=value` pairs, for example `client=acme,env=prod`. Merged with the API key's default tags; the `tags` body field wins on the same key. `X-OmniRelay-Tags` is the same header under its former name and stays accepted.","schema":{"type":"string","isRequired":false,"description":"Tags for this call as comma-separated `key=value` pairs, for example `client=acme,env=prod`. Merged with the API key's default tags; the `tags` body field wins on the same key. `X-OmniRelay-Tags` is the same header under its former name and stays accepted.","uniqueKey":"","typeLabel":"string"},"example":"client=acme,env=prod"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","content"],"additionalProperties":false,"properties":{"model":{"type":"string","description":"A video model ID from GET /v1/models (type video).","example":"doubao-seedance-2-0-260128","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"content":{"type":"array","minItems":1,"maxItems":1,"description":"Exactly one text item, 1 to 4000 characters.","items":{"type":"object","required":["type","text"],"additionalProperties":false,"properties":{"type":{"type":"string","enum":["text"],"isRequired":true,"uniqueKey":"content.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","maxLength":4000,"isRequired":true,"uniqueKey":"content.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"content.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"content","typeLabel":"object[]"},"resolution":{"type":"string","enum":["480p","720p"],"default":"480p","uniqueKey":"resolution","typeLabel":"enum\u003cstring>"},"ratio":{"type":"string","enum":["16:9","4:3","1:1","3:4","9:16","21:9","adaptive"],"default":"16:9","uniqueKey":"ratio","typeLabel":"enum\u003cstring>"},"duration":{"type":"integer","minimum":4,"maximum":10,"default":5,"description":"Length in whole seconds.","uniqueKey":"duration","typeLabel":"integer"},"seed":{"type":"integer","minimum":-1,"maximum":4294967295,"uniqueKey":"seed","typeLabel":"integer"},"generate_audio":{"type":"boolean","description":"The clip has a soundtrack unless this is false.","uniqueKey":"generate_audio","typeLabel":"boolean"},"watermark":{"type":"boolean","uniqueKey":"watermark","typeLabel":"boolean"},"camera_fixed":{"type":"boolean","uniqueKey":"camera_fixed","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"example":{"model":"doubao-seedance-2-0-260128","content":[{"type":"text","text":"A paper boat drifting on a calm pond at sunrise, slow camera pan"}],"resolution":"480p","ratio":"16:9","duration":5},"examples":{"Example":{"title":"Example","value":{"model":"doubao-seedance-2-0-260128","content":[{"type":"text","text":"A paper boat drifting on a calm pond at sunrise, slow camera pan"}],"resolution":"480p","ratio":"16:9","duration":5}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f54cf515-afd5-47df-82ca-8ff4139de0d5":{"description":"Task accepted and its hold dispatched.","headers":{"X-Request-ID":{"description":"OmniRelay task ID; the same value as the id in the body.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Task ID. Poll it with GET /api/v3/contents/generations/tasks/{id}.","isRequired":true,"uniqueKey":"id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"3f0c9a2e-6b1d-4c35-9a7e-2d8c5b1e4f60"},"examples":{"Example":{"title":"Example","value":{"id":"3f0c9a2e-6b1d-4c35-9a7e-2d8c5b1e4f60"}}},"exampleType":"examples"}},"exampleType":"examples"},"0d534850-8754-4ac3-b7ec-fb97150ec567":{"description":"invalid_parameter: an unknown field, more than one content item, a non-text item, or a value outside the documented range; error.param names the field. Nothing is sent or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_parameter"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_parameter"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"},"3a4c46c9-b119-4295-a364-882f6df3ac8f":{"description":"`unauthorized`: the API key is missing, revoked, or invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthorized"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized"}}}},"exampleType":"examples"}},"exampleType":"examples"},"cc39dc6b-0cfe-455b-bd15-f6270ab8897a":{"description":"inference_budget_or_access_denied or member_budget_exceeded: the hold cannot be covered. Rejected before dispatch.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"inference_budget_or_access_denied"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"inference_budget_or_access_denied"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"},"186c7ab9-3554-4e30-ac84-34b012789ba2":{"description":"model_not_allowed: the API key is limited to other models.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"model_not_allowed"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"model_not_allowed"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"},"95c85dec-97cd-4619-a958-109e7bed0add":{"description":"model_unavailable: not a video model this workspace can call.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"model_unavailable"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"model_unavailable"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"},"326fae90-e0f2-47a3-8b1b-183a3da2f1a4":{"description":"payload_too_large: the body is larger than 64 KiB.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"payload_too_large"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"payload_too_large"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"},"e1517588-4edd-403c-b91d-04b2c7b262bd":{"description":"Rate or concurrency limit. Nothing is charged; retry after Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limited"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"},"ccb994bd-fb83-47c0-b097-b370895def06":{"description":"video_submit_held: the task could not be confirmed after it was sent. Held for review and charged only if the video was generated. upstream_rejected: the provider refused the task; nothing is charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"video_submit_held"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"video_submit_held"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"},"1a111ea1-9f7b-4e04-a5fa-e16201acfa99":{"description":"Live video generation is not available for this workspace right now. Nothing is sent or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"live_provider_unavailable"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"live_provider_unavailable"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"},"367934aa-7b9e-4d85-adad-3b7c44d643c9":{"description":"video_submit_held: the submit timed out. Held for review and charged only if the video was generated.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","type"],"properties":{"code":{"type":"string","example":"model_unavailable","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"The model does not exist or is disabled.","description":"Short English description for logs and SDK exceptions. Its wording can change; branch on code.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"not_found_error","description":"Error family by HTTP status: invalid_request_error, authentication_error, insufficient_quota, permission_error, not_found_error, conflict_error, rate_limit_error, service_unavailable or api_error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"type":"string","maxLength":200,"description":"Rejected request field path when identifiable; never a parameter value. Responses uses native field names.","uniqueKey":"error.param","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"Present on chat completion, Responses and embeddings errors.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"video_submit_held"},"request_id":"2f6c1d0e9a"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"video_submit_held"},"request_id":"2f6c1d0e9a"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"0cfd7c8d-004d-4e0d-96de-988610dc14a3":{"bearerAuth":{"type":"http","scheme":"bearer","description":"An API key created in the OmniRelay console. The owner can view it again in the console after confirming their identity.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"8343319b-fc64-466b-b314-1aa49367d633":{"url":"https://api.omnirelay.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key created in the OmniRelay console. The owner can view it again in the console after confirming their identity.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key created in the OmniRelay console. The owner can view it again in the console after confirming their identity.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"mirvos","siteName":"OmniRelay Documentation","title":"Create video task - OmniRelay Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/videos/create-video-task","matchLevel":0},"cn":{"href":"/cn/api-reference/videos/create-video-task","matchLevel":1},"es":{"href":"/es/user-manual","matchLevel":4},"fr":{"href":"/fr/user-manual","matchLevel":4},"de":{"href":"/de/user-manual","matchLevel":4},"pt-BR":{"href":"/pt-BR/user-manual","matchLevel":4},"jp":{"href":"/jp/user-manual","matchLevel":4},"ko":{"href":"/ko/user-manual","matchLevel":4}}},"lastModified":"2026-11-02T19:46:13.833Z","originalFileLocation":"api-reference/videos/create-video-task.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=\"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OmniRelay Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_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=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create video task - OmniRelay Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OmniRelay Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://omnirelay.ai/docs/api-reference/videos/create-video-task\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mirvos.mintlify.site/docs/_mintlify/api/og/v2?division=Videos\u0026amp;title=Create+video+task\u0026amp;description=Submits+a+text-to-video+task+and+returns+its+ID+at+once%3B+poll+the+task+until+it+finishes.+Billed+by+output+tokens+generated+%28USD+25+per+million+list+price%29%3A+wid\u0026amp;theme=43c50d0778dfe81e3173fcea\u0026amp;signature=b753bfb14f9bb0211a6c7ba246088a0c7168bed4d236037781f8f3c123d87b19\">\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 task - OmniRelay Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mirvos.mintlify.site/docs/_mintlify/api/og/v2?division=Videos\u0026amp;title=Create+video+task\u0026amp;description=Submits+a+text-to-video+task+and+returns+its+ID+at+once%3B+poll+the+task+until+it+finishes.+Billed+by+output+tokens+generated+%28USD+25+per+million+list+price%29%3A+wid\u0026amp;theme=43c50d0778dfe81e3173fcea\u0026amp;signature=b753bfb14f9bb0211a6c7ba246088a0c7168bed4d236037781f8f3c123d87b19\">\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=\"/docs/mintlify-assets/_mintlify/favicons/mirvos/6nifCMTl7rKBlB9L/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OmniRelay Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3155f5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://omnirelay.ai/docs/api-reference/videos/create-video-task\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/videos/create-video-task.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://omnirelay.ai/docs/api-reference/videos/create-video-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://omnirelay.ai/docs/cn/api-reference/videos/create-video-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://omnirelay.ai/docs/api-reference/videos/create-video-task\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://omnirelay.ai/#organization\",\"name\":\"OmniRelay Documentation\",\"url\":\"https://omnirelay.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mirvos/m9J_0EZqJ57fDiaC/logo.svg?fit=max\u0026auto=format\u0026n=m9J_0EZqJ57fDiaC\u0026q=85\u0026s=ca602e0318071154028ed8989c7110cc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://omnirelay.ai/docs#website\",\"name\":\"OmniRelay Documentation\",\"url\":\"https://omnirelay.ai/docs\",\"publisher\":{\"@id\":\"https://omnirelay.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://omnirelay.ai/docs/api-reference/videos/create-video-task#webpage\",\"url\":\"https://omnirelay.ai/docs/api-reference/videos/create-video-task\",\"name\":\"Create video task\",\"description\":\"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.\",\"dateModified\":\"2026-11-02T19:46:13.833Z\",\"isPartOf\":{\"@id\":\"https://omnirelay.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://omnirelay.ai/docs/api-reference/videos/create-video-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://omnirelay.ai/docs/api-reference/videos/create-video-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OmniRelay Documentation\",\"item\":\"https://omnirelay.ai/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create video task\",\"item\":\"https://omnirelay.ai/docs/api-reference/videos/create-video-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://omnirelay.ai/docs/api-reference/videos/create-video-task#apireference\",\"headline\":\"Create video task\",\"name\":\"Create video task\",\"description\":\"Submits a text-to-video task and returns its ID at once; poll the task until it finishes. Billed by output tokens generated (USD 25 per million list price): width x height x (24 x seconds + 1) / 1024. The cost of the largest frame at the requested resolution and duration, plus 10 percent, is held at submit; a succeeded task settles the tokens actually generated, and failed, expired or cancelled tasks are not charged. Only the documented fields are accepted.\",\"url\":\"https://omnirelay.ai/docs/api-reference/videos/create-video-task\",\"mainEntityOfPage\":{\"@id\":\"https://omnirelay.ai/docs/api-reference/videos/create-video-task#webpage\"},\"dateModified\":\"2026-11-02T19:46:13.833Z\",\"publisher\":{\"@id\":\"https://omnirelay.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://omnirelay.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OmniRelay Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OmniRelay Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/videos/create-video-task.md","siteName":"OmniRelay Documentation","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"V1 Documentation","pages":[{"title":"V1 Documentation","href":""}]},{"tab":"V1 API Reference","groups":[{"group":"Service","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"/openapi.json get /health","href":"/api-reference/service/health-check"}]},{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/models","href":"/api-reference/models/list-models"}]},{"group":"Chat","pages":[{"title":"Create chat completion","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chat/completions","href":"/api-reference/chat/create-chat-completion"}]},{"group":"Management","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/manage/keys","href":"/api-reference/management/list-api-keys"},{"title":"Create API key","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/manage/keys","href":"/api-reference/management/create-api-key"},{"title":"List key budgets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/manage/keys/budgets","href":"/api-reference/management/list-key-budgets"},{"title":"Revoke API key","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/manage/keys/{id}","href":"/api-reference/management/revoke-api-key"},{"title":"Update API key","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/manage/keys/{id}","href":"/api-reference/management/update-api-key"},{"title":"Rotate API key","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/manage/keys/{id}/rotate","href":"/api-reference/management/rotate-api-key"},{"title":"Update key budget","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/manage/keys/{id}/budget","href":"/api-reference/management/update-key-budget"},{"title":"Read usage summary","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/manage/usage","href":"/api-reference/management/read-usage-summary"},{"title":"List request records","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/manage/requests","href":"/api-reference/management/list-request-records"}]},{"group":"Responses","pages":[{"title":"Create responses","deprecated":null,"version":null,"sidebarTitle":"Create responses","openapi":"/openapi.json post /v1/responses","href":"/api-reference/responses/create-response"}]},{"group":"Embeddings","pages":[{"title":"Create embeddings","deprecated":null,"version":null,"sidebarTitle":"Create embeddings","openapi":"/openapi.json post /v1/embeddings","href":"/api-reference/embeddings/create-embeddings"}]},{"group":"Images","pages":[{"title":"Create images","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/images/generations","href":"/api-reference/images/create-images"},{"title":"Edit images","description":"Edits or extends one or more uploaded images (multipart/form-data, fields `image` or `image[]`, optional `mask`). Billing, size tiers, `n`, `b64_json` output and the long-call behaviour are the same as Create images. The whole request may be up to 20 MiB.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/images/edits","href":"/api-reference/images/edit-images"}]},{"group":"Videos","pages":[{"title":"Create video task","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v3/contents/generations/tasks","href":"/api-reference/videos/create-video-task"},{"title":"Get video task","description":"Returns a task created with the same user. Reading a finished task settles its charge if that has not happened yet; tasks are settled when they finish whether or not they are read.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v3/contents/generations/tasks/{id}","href":"/api-reference/videos/get-video-task"}]}]}]},{"language":"cn","navbar":{"links":[{"href":"https://omnirelay.ai","label":"官网"},{"href":"https://omnirelay.instatus.com","label":"服务状态"}],"primary":{"type":"button","label":"打开控制台","href":"https://omnirelay.ai/login"}},"pages":[{"title":"cn","href":"/cn/api-reference/videos/create-video-task"}]},{"language":"es","navbar":{"links":[{"href":"https://omnirelay.ai","label":"Sitio web"},{"href":"https://omnirelay.instatus.com","label":"Estado"}],"primary":{"type":"button","label":"Abrir consola","href":"https://omnirelay.ai/login"}},"pages":[{"title":"es","href":"/es/user-manual"}]},{"language":"fr","navbar":{"links":[{"href":"https://omnirelay.ai","label":"Site web"},{"href":"https://omnirelay.instatus.com","label":"État du service"}],"primary":{"type":"button","label":"Ouvrir la console","href":"https://omnirelay.ai/login"}},"pages":[{"title":"fr","href":"/fr/user-manual"}]},{"language":"de","navbar":{"links":[{"href":"https://omnirelay.ai","label":"Website"},{"href":"https://omnirelay.instatus.com","label":"Dienststatus"}],"primary":{"type":"button","label":"Konsole öffnen","href":"https://omnirelay.ai/login"}},"pages":[{"title":"de","href":"/de/user-manual"}]},{"language":"pt-BR","navbar":{"links":[{"href":"https://omnirelay.ai","label":"Site"},{"href":"https://omnirelay.instatus.com","label":"Status"}],"primary":{"type":"button","label":"Abrir console","href":"https://omnirelay.ai/login"}},"pages":[{"title":"pt-BR","href":"/pt-BR/user-manual"}]},{"language":"jp","navbar":{"links":[{"href":"https://omnirelay.ai","label":"ウェブサイト"},{"href":"https://omnirelay.instatus.com","label":"サービス状況"}],"primary":{"type":"button","label":"コンソールを開く","href":"https://omnirelay.ai/login"}},"pages":[{"title":"jp","href":"/jp/user-manual"}]},{"language":"ko","navbar":{"links":[{"href":"https://omnirelay.ai","label":"웹사이트"},{"href":"https://omnirelay.instatus.com","label":"서비스 상태"}],"primary":{"type":"button","label":"콘솔 열기","href":"https://omnirelay.ai/login"}},"pages":[{"title":"ko","href":"/ko/user-manual"}]}]},"basePath":"","title":"Create video task - OmniRelay Documentation","buildId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","deploymentId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CASS2Vpq.js","utils-4k9fyWRu.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-UU-UueZb.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BgJ0LOYq.js","snippetPresets-CMgzlMR-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BzEJegkK.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CZuQIZdk.js","shallow-Bw5arfMA.js","getApiPlaygroundDisplay-Ds834aVN.js","CodeSnippet-CKzmjw9L.js","CodeSnippets-BRpgomdp.js","Page-DvEUoD2H.js","getPastedJson-B0N-Tn76.js","icon-DASMs9nC.js","MethodPill-BA6DBLqx.js","DuplicateIcon-BMT5qfbJ.js","createIcon-CNfwVWPx.js","DynamicMarkdown-JYyBNlrJ.js","SectionHeading-BbZnmz8a.js","axios-vUo_bRtp.js","Markdown-LUU0YLpA.js","clsx-Di4ek5Ae.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-VEVWQCR4.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CPszyu99.js"]}