{
"error": {
"code": "InvalidParameter",
"message": "Asset 'asset-20261020080000-abcde' is still processing. Use it after its status becomes Active.",
"param": "",
"type": "BadRequest"
}
}
{
"error": {
"code": "AuthenticationError",
"message": "The API key is missing or invalid.",
"param": "",
"type": "Unauthorized"
}
}
{
"error": {
"code": "InvalidEndpointOrModel.NotFound",
"message": "The model or endpoint does not exist or you do not have access to it.",
"param": "",
"type": "NotFound"
}
}
Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.
POST
/
api
/
v3
/
contents
/
generations
/
tasks
Create a Seedance video generation task
curl --request POST \
--url https://api-vip.apigo.ai/api/v3/contents/generations/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "dreamina-seedance-2-0-260128",
"content": [
{
"type": "text",
"text": "Make the apple in image 1 move slightly while keeping the subject and composition."
},
{
"type": "image_url",
"role": "reference_image",
"image_url": {
"url": "asset://asset-20261020080000-abcde"
}
}
],
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"generate_audio": false,
"watermark": false
}
'
{
"error": {
"code": "InvalidParameter",
"message": "Asset 'asset-20261020080000-abcde' is still processing. Use it after its status becomes Active.",
"param": "",
"type": "BadRequest"
}
}
{
"error": {
"code": "AuthenticationError",
"message": "The API key is missing or invalid.",
"param": "",
"type": "Unauthorized"
}
}
{
"error": {
"code": "InvalidEndpointOrModel.NotFound",
"message": "The model or endpoint does not exist or you do not have access to it.",
"param": "",
"type": "NotFound"
}
}
Authenticate with Authorization: Bearer <API_KEY>. Tasks run asynchronously: a successful call only returns the task ID. Call Get video generation task for the result.
url can be an asset in the asset library with Status=Active (asset://<asset ID>), or a publicly reachable HTTP(S) URL. See Asset library for importing assets.
In the prompt, refer to reference media as “image 1”, “audio 1”, “video 1” by their order within each type in content.
Audio cannot be the only reference media; combine it with an image or video.
audio_url is an input reference, while generate_audio controls whether the output video has sound. They are independent. Set generate_audio to true when using a reference audio or the original sound of a reference video.
Asset '<ID>' failed processing and cannot be used.
Processing failed. Fix the source file and import it again
The referenced assets cannot be used together in one request.
The referenced assets cannot be combined in one request. Create a new asset group, re-import all assets needed for this request into it, and reference them once all are Active
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"docs.apigo.ai","colors":{"primary":"#427be8","light":"#427be8","dark":"#427be8"},"logo":{"light":"https://mintcdn.com/indie-9a166471/Wx7pzV9uA_aQFqlk/logo/apigo-logo.png?fit=max\u0026auto=format\u0026n=Wx7pzV9uA_aQFqlk\u0026q=85\u0026s=40f586412e093054e1ba129aeaca6b1c","dark":"https://mintcdn.com/indie-9a166471/Wx7pzV9uA_aQFqlk/logo/apigo-logo.png?fit=max\u0026auto=format\u0026n=Wx7pzV9uA_aQFqlk\u0026q=85\u0026s=40f586412e093054e1ba129aeaca6b1c"},"favicon":"https://mintcdn.com/indie-9a166471/Wx7pzV9uA_aQFqlk/favicon.png?fit=max\u0026auto=format\u0026n=Wx7pzV9uA_aQFqlk\u0026q=85\u0026s=383512c95b61bd38955835c060a43a9b","appearance":{"strict":false},"styling":{"latex":false},"navigation":{"languages":[{"language":"cn","navbar":{"primary":{"type":"button","label":"ApiGo","href":"https://vip.apigo.ai"}},"href":"api-reference/guide/interface-overview"},{"language":"en","navbar":{"primary":{"type":"button","label":"ApiGo","href":"https://vip.apigo.ai"}},"href":"en/api-reference/guide/interface-overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"indie-9a166471","hasAudioNarration":false,"actualSubdomain":"indie-9a166471","customDomains":["docs-vip.apigo.ai"],"gitSource":{"type":"github","owner":"apigo-ai","repo":"apigo-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aeaa7a2a6bc42a735e1582f","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"cn","tag":"API参考","count":56},{"language":"en","tag":"API Reference","count":56},{"language":"cn","tag":"使用示例","count":27},{"language":"en","tag":"Usage Examples","count":27},{"language":"cn","tag":"API端点","count":25},{"language":"en","tag":"API Endpoints","count":25},{"language":"cn","tag":"Seedance","count":15},{"language":"en","tag":"Seedance","count":15},{"language":"cn","tag":"素材库","count":13},{"language":"en","tag":"Asset library","count":13},{"language":"cn","tag":"文本","count":5},{"language":"en","tag":"Text","count":5},{"language":"cn","tag":"图片","count":4},{"language":"cn","tag":"OpenAI","count":4},{"language":"cn","tag":"接口指南","count":4},{"language":"en","tag":"Image","count":4},{"language":"en","tag":"OpenAI","count":4},{"language":"en","tag":"Interface Guide","count":4},{"language":"cn","tag":"Claude","count":3},{"language":"en","tag":"Claude","count":3}]},"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#sidebar a:has(.method-nav-pill){display:grid;grid-template-columns:2.9rem minmax(0, 1fr);align-items:center;column-gap:0.72rem;min-height:2.4rem;margin:0.14rem 0;padding:0.34rem 0.88rem 0.34rem 0.56rem!important;border-radius:1rem;transition:background-color 180ms ease,\n color 180ms ease,\n transform 180ms ease,\n box-shadow 180ms ease}#sidebar a:has(.method-nav-pill):hover{transform:translateX(1px)}#sidebar a:has(.method-nav-pill) .method-nav-pill{display:inline-flex;align-items:center;justify-content:center;width:2.9rem;min-height:1.55rem}#sidebar a:has(.method-nav-pill) .method-nav-pill>span{min-width:2.42rem;padding:0.3rem 0.5rem!important;border-radius:999px!important;font-size:0.64rem!important;line-height:1.05!important;font-weight:800!important;letter-spacing:0.02em;box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.18)}#sidebar a:has(.method-nav-pill)>div:last-child{min-width:0;display:flex;align-items:center;font-size:0.9rem;line-height:1.08;font-weight:500;letter-spacing:-0.01em;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}#sidebar a:has(.method-nav-pill).text-primary{background-color:#ebf8ef!important;box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.58),\n inset 0 0 0 1px #d3edde}#sidebar a:has(.method-nav-pill).text-primary .method-nav-pill>span{background:#2f67f6!important;color:#ffffff!important}#sidebar a:has(.method-nav-pill).text-gray-700 .method-nav-pill>span{background:rgba(47, 103, 246, 0.12)!important;color:#2f67f6!important}#sidebar a[href*=\"/api-reference/endpoints/\"]:not(:has(.method-nav-pill)),#sidebar a[href*=\"/en/api-reference/endpoints/\"]:not(:has(.method-nav-pill)){--endpoint-badge-text: \"POST\";--endpoint-badge-bg: rgba(47, 103, 246, 0.12);--endpoint-badge-color: #2f67f6;display:grid;grid-template-columns:2.9rem minmax(0, 1fr);align-items:center;column-gap:0.72rem;min-height:2.4rem;margin:0.14rem 0;padding:0.34rem 0.88rem 0.34rem 0.56rem!important;border-radius:1rem;transition:background-color 180ms ease,\n color 180ms ease,\n transform 180ms ease,\n box-shadow 180ms ease}#sidebar a[href*=\"/api-reference/endpoints/\"]:not(:has(.method-nav-pill)):hover,#sidebar a[href*=\"/en/api-reference/endpoints/\"]:not(:has(.method-nav-pill)):hover{transform:translateX(1px)}#sidebar a[href*=\"/api-reference/endpoints/\"]:not(:has(.method-nav-pill))::before,#sidebar a[href*=\"/en/api-reference/endpoints/\"]:not(:has(.method-nav-pill))::before{content:var(--endpoint-badge-text);display:inline-flex;align-items:center;justify-content:center;width:2.42rem;min-width:2.42rem;min-height:1.55rem;padding:0.3rem 0.5rem;border-radius:999px;font-size:0.64rem;line-height:1.05;font-weight:800;letter-spacing:0.02em;color:var(--endpoint-badge-color);background:var(--endpoint-badge-bg);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.18)}#sidebar a[href*=\"/api-reference/endpoints/\"]:not(:has(.method-nav-pill))>div:last-child,#sidebar a[href*=\"/en/api-reference/endpoints/\"]:not(:has(.method-nav-pill))>div:last-child{min-width:0;display:flex;align-items:center;font-size:0.9rem;line-height:1.08;font-weight:500;letter-spacing:-0.01em;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}#sidebar a[href*=\"/api-reference/endpoints/\"]:not(:has(.method-nav-pill)).text-primary,#sidebar a[href*=\"/en/api-reference/endpoints/\"]:not(:has(.method-nav-pill)).text-primary{background-color:#ebf8ef!important;box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.58),\n inset 0 0 0 1px #d3edde}#sidebar a[href*=\"/api-reference/endpoints/\"]:not(:has(.method-nav-pill)).text-primary::before,#sidebar a[href*=\"/en/api-reference/endpoints/\"]:not(:has(.method-nav-pill)).text-primary::before{background:var(--endpoint-badge-color);color:#ffffff}#sidebar a[href*=\"/api-reference/endpoints/openai/video-status\"]:not(:has(.method-nav-pill)),#sidebar a[href*=\"/api-reference/endpoints/openai/video-content\"]:not(:has(.method-nav-pill)),#sidebar a[href*=\"/en/api-reference/endpoints/openai/video-status\"]:not(:has(.method-nav-pill)),#sidebar a[href*=\"/en/api-reference/endpoints/openai/video-content\"]:not(:has(.method-nav-pill)),#sidebar a[href*=\"/api-reference/endpoints/gemini/video-operations\"]:not(:has(.method-nav-pill)),#sidebar a[href*=\"/en/api-reference/endpoints/gemini/video-operations\"]:not(:has(.method-nav-pill)){--endpoint-badge-text: \"GET\";--endpoint-badge-bg: rgba(15, 160, 133, 0.14);--endpoint-badge-color: #0f9f85}#sidebar a[href*=\"/api-reference/endpoints/openai/video-status\"]:not(:has(.method-nav-pill))::before,#sidebar a[href*=\"/api-reference/endpoints/openai/video-content\"]:not(:has(.method-nav-pill))::before,#sidebar a[href*=\"/en/api-reference/endpoints/openai/video-status\"]:not(:has(.method-nav-pill))::before,#sidebar a[href*=\"/en/api-reference/endpoints/openai/video-content\"]:not(:has(.method-nav-pill))::before,#sidebar a[href*=\"/api-reference/endpoints/gemini/video-operations\"]:not(:has(.method-nav-pill))::before,#sidebar a[href*=\"/en/api-reference/endpoints/gemini/video-operations\"]:not(:has(.method-nav-pill))::before{content:\"GET\"}#sidebar a[href*=\"/api-reference/endpoints/seedance/asset-overview\"]:not(:has(.method-nav-pill)){display:flex}#sidebar a[href*=\"/api-reference/endpoints/seedance/asset-overview\"]:not(:has(.method-nav-pill))::before{content:none}@media (max-width: 1280px){#sidebar a:has(.method-nav-pill)>div:last-child{font-size:0.9rem}#sidebar a[href*=\"/api-reference/endpoints/\"]:not(:has(.method-nav-pill))>div:last-child,#sidebar a[href*=\"/en/api-reference/endpoints/\"]:not(:has(.method-nav-pill))>div:last-child{font-size:0.9rem}}"}],"page":{"pagePath":"en/api-reference/endpoints/seedance/create-task","slug":"/en/api-reference/endpoints/seedance/create-task","pageMetadata":{"title":"/api/v3/contents/generations/tasks","sidebarTitle":"Create video generation task","openapi":"en/api-reference/openapi.json POST /api/v3/contents/generations/tasks","description":"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.","href":"/en/api-reference/endpoints/seedance/create-task"},"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: \"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Authenticate with `,_jsx(_components.code,{children:`Authorization: Bearer \u003cAPI_KEY>`}),`. Tasks run asynchronously: a successful call only returns the task ID. Call `,_jsx(_components.a,{href:`/en/api-reference/endpoints/seedance/get-task`,children:`Get video generation task`}),` for the result.`]}),`\n`,_jsx(Heading,{level:`2`,id:`models`,children:`Models`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Model ID`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`dreamina-seedance-2-0-260128`})}),_jsx(_components.td,{children:`Seedance 2.0`})]})})]}),`\n`,_jsx(_components.p,{children:`Available durations, resolutions, aspect ratios and pricing depend on what is enabled for your account.`}),`\n`,_jsx(Heading,{level:`2`,id:`content-items`,children:`content items`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Format`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Text`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"type\":\"text\",\"text\":\"prompt\"}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Image`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"type\":\"image_url\",\"role\":\"reference_image\",\"image_url\":{\"url\":\"asset://\u003casset ID>\"}}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Audio`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"type\":\"audio_url\",\"role\":\"reference_audio\",\"audio_url\":{\"url\":\"asset://\u003casset ID>\"}}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Video`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"type\":\"video_url\",\"role\":\"reference_video\",\"video_url\":{\"url\":\"asset://\u003casset ID>\"}}`})})]})]})]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`url`}),` can be an asset in the asset library with `,_jsx(_components.code,{children:`Status=Active`}),` (`,_jsx(_components.code,{children:`asset://\u003casset ID>`}),`), or a publicly reachable HTTP(S) URL. See `,_jsx(_components.a,{href:`/en/api-reference/endpoints/seedance/asset-overview`,children:`Asset library`}),` for importing assets.`]}),`\n`,_jsxs(_components.li,{children:[`In the prompt, refer to reference media as “image 1”, “audio 1”, “video 1” by their order within each type in `,_jsx(_components.code,{children:`content`}),`.`]}),`\n`,_jsx(_components.li,{children:`Audio cannot be the only reference media; combine it with an image or video.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`audio_url`}),` is an input reference, while `,_jsx(_components.code,{children:`generate_audio`}),` controls whether the output video has sound. They are independent. Set `,_jsx(_components.code,{children:`generate_audio`}),` to `,_jsx(_components.code,{children:`true`}),` when using a reference audio or the original sound of a reference video.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`asset-reference-errors`,children:`Asset reference errors`}),`\n`,_jsxs(_components.p,{children:[`When a referenced asset cannot be used, HTTP 400 is returned with `,_jsx(_components.code,{children:`error.code`}),` set to `,_jsx(_components.code,{children:`InvalidParameter`}),`:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`message`}),_jsx(_components.th,{children:`Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Asset '\u003cID>' does not exist.`})}),_jsx(_components.td,{children:`Check that the asset ID is correct and has not been deleted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Asset '\u003cID>' is still processing. Use it after its status becomes Active.`})}),_jsxs(_components.td,{children:[`Wait until `,_jsx(_components.a,{href:`/en/api-reference/endpoints/seedance/get-asset`,children:`GetAsset`}),` returns `,_jsx(_components.code,{children:`Active`}),`, then resubmit`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Asset '\u003cID>' failed processing and cannot be used.`})}),_jsx(_components.td,{children:`Processing failed. Fix the source file and import it again`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`The referenced assets cannot be used together in one request.`})}),_jsxs(_components.td,{children:[`The referenced assets cannot be combined in one request. Create a new asset group, re-import all assets needed for this request into it, and reference them once all are `,_jsx(_components.code,{children:`Active`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`error-codes`,children:`Error codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP status`}),_jsx(_components.th,{children:`error.type`}),_jsx(_components.th,{children:`error.code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BadRequest`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`InvalidParameter`})}),_jsx(_components.td,{children:`Invalid JSON, missing fields, wrong types, or unusable asset references`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BadRequest`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`InvalidParameter.UnsupportedImageFormat`}),`, `,_jsx(_components.code,{children:`InputImageSensitiveContentDetected`}),`, etc.`]}),_jsxs(_components.td,{children:[`Media format, parameter or content moderation check failed. `,_jsx(_components.code,{children:`param`}),` may be empty; also read `,_jsx(_components.code,{children:`message`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Unauthorized`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AuthenticationError`})}),_jsx(_components.td,{children:`Missing or invalid API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Forbidden`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AccountOverdueError`})}),_jsx(_components.td,{children:`Insufficient balance`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Forbidden`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AccessDenied`})}),_jsx(_components.td,{children:`Blocked by IP allowlist or model permission`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NotFound`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`InvalidEndpointOrModel.NotFound`})}),_jsx(_components.td,{children:`Model does not exist or is unavailable`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TooManyRequests`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AccountRateLimitExceeded`})}),_jsx(_components.td,{children:`Too many requests`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TooManyRequests`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`QuotaExceeded`})}),_jsx(_components.td,{children:`API key quota reached`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`InternalServerError`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`InternalServiceError`})}),_jsx(_components.td,{children:`Internal or upstream error`})]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`If a create request times out or the connection drops, the task may already have been created. Retrying blindly can create duplicate tasks.`})})]})}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":"/api/v3/contents/generations/tasks","sidebarTitle":"Create video generation task","openapi":"en/api-reference/openapi.json POST /api/v3/contents/generations/tasks","description":"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.","href":"/en/api-reference/endpoints/seedance/create-task"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Models","slug":"models","depth":2,"children":[]},{"title":"content items","slug":"content-items","depth":2,"children":[]},{"title":"Asset reference errors","slug":"asset-reference-errors","depth":2,"children":[]},{"title":"Error codes","slug":"error-codes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a Seedance video generation task","description":"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.","requestBody":"f047e859-f800-41cc-8764-2ae1d1c255a8","responses":{"200":"54a3b5c1-73a9-458e-abaa-cf655a492ccd","400":"e8037836-ad2c-450b-87f8-6dbd248437b0","401":"77c7a528-5f37-425f-9b10-a71bf171969b","403":"cf30094b-53f2-4a00-a9e4-2c9a587affaa","404":"5f1f8c9a-e1f1-487a-b4c5-243ee3e86a71","429":"8ebeddb9-204d-476e-ba88-883a3600d017"},"method":"post","type":"path","servers":["f158fc65-3cd3-4ab8-b84f-633419fce43e"],"security":["8f7bafda-b2f1-4a3b-b5b6-f213221215ce"],"path":"/api/v3/contents/generations/tasks","baseUrlOptions":["https://api-vip.apigo.ai"],"title":"Create a Seedance video generation task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","content"],"properties":{"model":{"type":"string","description":"Model ID.","example":"dreamina-seedance-2-0-260128","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"content":{"type":"array","description":"Array of prompt text and reference media. In the prompt, refer to media as \"image 1\", \"audio 1\", \"video 1\" by their order within each type.","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["text","image_url","audio_url","video_url"],"description":"Content type.","isRequired":true,"uniqueKey":"content.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","description":"Prompt text. Required when `type=text`.","uniqueKey":"content.items.[INDEX].text","typeLabel":"string"},"role":{"type":"string","enum":["reference_image","reference_audio","reference_video"],"description":"Reference media role matching `type`: `reference_image` / `reference_audio` / `reference_video`.","uniqueKey":"content.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"image_url":{"type":"object","description":"Reference image. Required when `type=image_url`.","required":["url"],"properties":{"url":{"type":"string","description":"`asset://\u003casset ID>` (the asset must be `Active`), or a publicly reachable HTTP(S) URL.","isRequired":true,"uniqueKey":"content.items.[INDEX].image_url.url","typeLabel":"string"}},"uniqueKey":"content.items.[INDEX].image_url","typeLabel":"object"},"audio_url":{"type":"object","description":"Reference audio. Required when `type=audio_url`. Audio cannot be the only reference media; combine it with an image or video.","required":["url"],"properties":{"url":{"type":"string","description":"`asset://\u003casset ID>` (the asset must be `Active`), or a publicly reachable HTTP(S) URL.","isRequired":true,"uniqueKey":"content.items.[INDEX].audio_url.url","typeLabel":"string"}},"uniqueKey":"content.items.[INDEX].audio_url","typeLabel":"object"},"video_url":{"type":"object","description":"Reference video. Required when `type=video_url`.","required":["url"],"properties":{"url":{"type":"string","description":"`asset://\u003casset ID>` (the asset must be `Active`), or a publicly reachable HTTP(S) URL.","isRequired":true,"uniqueKey":"content.items.[INDEX].video_url.url","typeLabel":"string"}},"uniqueKey":"content.items.[INDEX].video_url","typeLabel":"object"}},"uniqueKey":"content.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"content","typeLabel":"object[]"},"duration":{"type":"integer","description":"Video length in seconds.","example":5,"uniqueKey":"duration","typeLabel":"integer"},"resolution":{"type":"string","description":"Output resolution, for example `720p`.","example":"720p","uniqueKey":"resolution","typeLabel":"string"},"ratio":{"type":"string","description":"Aspect ratio, for example `16:9` or `1:1`.","example":"16:9","uniqueKey":"ratio","typeLabel":"string"},"generate_audio":{"type":"boolean","description":"Whether to generate sound. Set to `true` when using a reference audio or the original sound of a reference video.","uniqueKey":"generate_audio","typeLabel":"boolean"},"watermark":{"type":"boolean","description":"Whether to add a watermark.","uniqueKey":"watermark","typeLabel":"boolean"},"priority":{"type":"integer","description":"Task priority. Echoed back in the query result when provided.","uniqueKey":"priority","typeLabel":"integer"},"safety_identifier":{"type":"string","description":"End-user identifier. Use an irreversible hash. Echoed back in the query result when provided.","uniqueKey":"safety_identifier","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"model":"dreamina-seedance-2-0-260128","content":[{"type":"text","text":"Make the apple in image 1 move slightly while keeping the subject and composition."},{"type":"image_url","role":"reference_image","image_url":{"url":"asset://asset-20261020080000-abcde"}}],"duration":5,"resolution":"720p","ratio":"16:9","generate_audio":false,"watermark":false},"examples":{"Example":{"title":"Example","value":{"model":"dreamina-seedance-2-0-260128","content":[{"type":"text","text":"Make the apple in image 1 move slightly while keeping the subject and composition."},{"type":"image_url","role":"reference_image","image_url":{"url":"asset://asset-20261020080000-abcde"}}],"duration":5,"resolution":"720p","ratio":"16:9","generate_audio":false,"watermark":false}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"54a3b5c1-73a9-458e-abaa-cf655a492ccd":{"description":"Task created","content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Task ID.","isRequired":true,"uniqueKey":"id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"task_20261020080000abcdef"},"examples":{"Example":{"title":"Example","value":{"id":"task_20261020080000abcdef"}}},"exampleType":"examples"}},"exampleType":"examples"},"e8037836-ad2c-450b-87f8-6dbd248437b0":{"description":"Invalid parameters or asset reference","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"Error object.","properties":{"code":{"type":"string","description":"Error code, for example `InvalidParameter`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Error message.","uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Name of the offending parameter. May be empty.","uniqueKey":"error.param","typeLabel":"string"},"type":{"type":"string","description":"Error type, for example `BadRequest`.","uniqueKey":"error.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"InvalidParameter","message":"Asset 'asset-20261020080000-abcde' is still processing. Use it after its status becomes Active.","param":"","type":"BadRequest"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"InvalidParameter","message":"Asset 'asset-20261020080000-abcde' is still processing. Use it after its status becomes Active.","param":"","type":"BadRequest"}}}},"exampleType":"examples"}},"exampleType":"examples"},"77c7a528-5f37-425f-9b10-a71bf171969b":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"Error object.","properties":{"code":{"type":"string","description":"Error code, for example `InvalidParameter`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Error message.","uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Name of the offending parameter. May be empty.","uniqueKey":"error.param","typeLabel":"string"},"type":{"type":"string","description":"Error type, for example `BadRequest`.","uniqueKey":"error.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"AuthenticationError","message":"The API key is missing or invalid.","param":"","type":"Unauthorized"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AuthenticationError","message":"The API key is missing or invalid.","param":"","type":"Unauthorized"}}}},"exampleType":"examples"}},"exampleType":"examples"},"cf30094b-53f2-4a00-a9e4-2c9a587affaa":{"description":"Insufficient balance, or blocked by IP allowlist or model permission","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"Error object.","properties":{"code":{"type":"string","description":"Error code, for example `InvalidParameter`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Error message.","uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Name of the offending parameter. May be empty.","uniqueKey":"error.param","typeLabel":"string"},"type":{"type":"string","description":"Error type, for example `BadRequest`.","uniqueKey":"error.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"AccountOverdueError","message":"Your account balance is insufficient.","param":"","type":"Forbidden"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AccountOverdueError","message":"Your account balance is insufficient.","param":"","type":"Forbidden"}}}},"exampleType":"examples"}},"exampleType":"examples"},"5f1f8c9a-e1f1-487a-b4c5-243ee3e86a71":{"description":"Model does not exist or is unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"Error object.","properties":{"code":{"type":"string","description":"Error code, for example `InvalidParameter`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Error message.","uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Name of the offending parameter. May be empty.","uniqueKey":"error.param","typeLabel":"string"},"type":{"type":"string","description":"Error type, for example `BadRequest`.","uniqueKey":"error.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"InvalidEndpointOrModel.NotFound","message":"The model or endpoint does not exist or you do not have access to it.","param":"","type":"NotFound"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"InvalidEndpointOrModel.NotFound","message":"The model or endpoint does not exist or you do not have access to it.","param":"","type":"NotFound"}}}},"exampleType":"examples"}},"exampleType":"examples"},"8ebeddb9-204d-476e-ba88-883a3600d017":{"description":"Too many requests or API key quota reached","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"Error object.","properties":{"code":{"type":"string","description":"Error code, for example `InvalidParameter`.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Error message.","uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Name of the offending parameter. May be empty.","uniqueKey":"error.param","typeLabel":"string"},"type":{"type":"string","description":"Error type, for example `BadRequest`.","uniqueKey":"error.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"AccountRateLimitExceeded","message":"Too many requests, please retry later.","param":"","type":"TooManyRequests"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AccountRateLimitExceeded","message":"Too many requests, please retry later.","param":"","type":"TooManyRequests"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"8f7bafda-b2f1-4a3b-b5b6-f213221215ce":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"f158fc65-3cd3-4ab8-b84f-633419fce43e":{"url":"https://api-vip.apigo.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"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":"en/api-reference/openapi.json"},"subdomain":"indie-9a166471","siteName":"docs.apigo.ai","title":"/api/v3/contents/generations/tasks - docs.apigo.ai","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"cn":{"href":"/api-reference/endpoints/seedance/create-task","matchLevel":1},"en":{"href":"/en/api-reference/endpoints/seedance/create-task","matchLevel":0}}},"lastModified":"2026-10-27T08:07:28.764Z","originalFileLocation":"en/api-reference/endpoints/seedance/create-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=\"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.\">\u003cmeta data-mint-head name=\"application-name\" content=\"docs.apigo.ai\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/indie-9a166471/rBcsed2GxmyXVh0I/_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/indie-9a166471/rBcsed2GxmyXVh0I/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/indie-9a166471/rBcsed2GxmyXVh0I/_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/indie-9a166471/rBcsed2GxmyXVh0I/_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/indie-9a166471/rBcsed2GxmyXVh0I/_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/indie-9a166471/rBcsed2GxmyXVh0I/_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/indie-9a166471/rBcsed2GxmyXVh0I/_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/indie-9a166471/rBcsed2GxmyXVh0I/_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/indie-9a166471/rBcsed2GxmyXVh0I/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"/api/v3/contents/generations/tasks - docs.apigo.ai\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"docs.apigo.ai\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://indie-9a166471.mintlify.site/_mintlify/api/og/v2?division=Video\u0026amp;title=%2Fapi%2Fv3%2Fcontents%2Fgenerations%2Ftasks\u0026amp;description=Submit+a+prompt+and+reference+media+to+generate+a+video+asynchronously.+A+successful+call+only+returns+the+task+ID%3B+poll+the+query+endpoint+for+the+result.\u0026amp;theme=26508e6cdc1e726bcbffb73a\u0026amp;signature=3122b90dcca24c213d6a9e26a0175716b244587cb8e5dd68ec33f6b2dd0703ea\">\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=\"/api/v3/contents/generations/tasks - docs.apigo.ai\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://indie-9a166471.mintlify.site/_mintlify/api/og/v2?division=Video\u0026amp;title=%2Fapi%2Fv3%2Fcontents%2Fgenerations%2Ftasks\u0026amp;description=Submit+a+prompt+and+reference+media+to+generate+a+video+asynchronously.+A+successful+call+only+returns+the+task+ID%3B+poll+the+query+endpoint+for+the+result.\u0026amp;theme=26508e6cdc1e726bcbffb73a\u0026amp;signature=3122b90dcca24c213d6a9e26a0175716b244587cb8e5dd68ec33f6b2dd0703ea\">\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/indie-9a166471/rBcsed2GxmyXVh0I/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"docs.apigo.ai\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#427be8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task\">\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/endpoints/seedance/create-task.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs-vip.apigo.ai/api-reference/endpoints/seedance/create-task\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs-vip.apigo.ai/api-reference/endpoints/seedance/create-task\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs-vip.apigo.ai/#organization\",\"name\":\"docs.apigo.ai\",\"url\":\"https://docs-vip.apigo.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/indie-9a166471/Wx7pzV9uA_aQFqlk/logo/apigo-logo.png?fit=max\u0026auto=format\u0026n=Wx7pzV9uA_aQFqlk\u0026q=85\u0026s=40f586412e093054e1ba129aeaca6b1c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs-vip.apigo.ai#website\",\"name\":\"docs.apigo.ai\",\"url\":\"https://docs-vip.apigo.ai\",\"publisher\":{\"@id\":\"https://docs-vip.apigo.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task#webpage\",\"url\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task\",\"name\":\"/api/v3/contents/generations/tasks\",\"description\":\"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.\",\"dateModified\":\"2026-10-27T08:07:28.764Z\",\"isPartOf\":{\"@id\":\"https://docs-vip.apigo.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/openai/chat-completions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"/api/v3/contents/generations/tasks\",\"item\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task#apireference\",\"headline\":\"/api/v3/contents/generations/tasks\",\"name\":\"/api/v3/contents/generations/tasks\",\"description\":\"Submit a prompt and reference media to generate a video asynchronously. A successful call only returns the task ID; poll the query endpoint for the result.\",\"url\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/create-task#webpage\"},\"dateModified\":\"2026-10-27T08:07:28.764Z\",\"publisher\":{\"@id\":\"https://docs-vip.apigo.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs-vip.apigo.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"docs.apigo.ai\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"docs.apigo.ai","nav":{"global":null,"languages":[{"language":"cn","navbar":{"primary":{"type":"button","label":"ApiGo","href":"https://vip.apigo.ai"}},"pages":[{"title":"cn","href":"/api-reference/endpoints/seedance/create-task"}]},{"language":"en","navbar":{"primary":{"type":"button","label":"ApiGo","href":"https://vip.apigo.ai"}},"tabs":[{"tab":"API Reference","groups":[{"group":"Interface Guide","pages":[{"title":"Usage Overview","href":"/en/api-reference/guide/interface-overview"},{"title":"Rate Limits","href":"/en/api-reference/guide/rate-limits"},{"title":"Error codes and handling","href":"/en/api-reference/guide/error-codes"},{"title":"Request IDs","href":"/en/api-reference/guide/request-ids"}]},{"group":"API Endpoints","pages":[{"group":"OpenAI","pages":[{"group":"Text","pages":[{"title":"/v1/chat/completions","openapi":"POST /v1/chat/completions","href":"/en/api-reference/endpoints/openai/chat-completions"},{"title":"/v1/responses","openapi":"POST /v1/responses","href":"/en/api-reference/endpoints/openai/responses"}]},{"group":"Image","pages":[{"title":"/v1/images/generations","openapi":"POST /v1/images/generations","href":"/en/api-reference/endpoints/openai/image"},{"title":"/v1/images/edits","openapi":"POST /v1/images/edits","href":"/en/api-reference/endpoints/openai/image-edits"}]}]},{"group":"Claude","pages":[{"group":"Text","pages":[{"title":"/v1/messages","openapi":"POST /v1/messages","href":"/en/api-reference/endpoints/claude/text"}]},{"group":"Image","pages":[{"title":"/v1/messages","openapi":"POST /v1/messages","href":"/en/api-reference/endpoints/claude/image"}]},{"group":"Video","pages":[{"title":"/v1/messages","openapi":"POST /v1/messages","href":"/en/api-reference/endpoints/claude/video"}]}]},{"group":"Gemini","pages":[{"group":"Text","pages":[{"title":"/v1beta/models/{model}:generateContent","openapi":"POST /v1beta/models/{model}:generateContent","href":"/en/api-reference/endpoints/gemini/text"},{"title":"/v1beta/models/{model}:streamGenerateContent","openapi":"POST /v1beta/models/{model}:streamGenerateContent","href":"/en/api-reference/endpoints/gemini/text-stream-generate-content"}]},{"group":"Image","pages":[{"title":"/v1beta/models/{model}:generateContent","openapi":"en/api-reference/openapi.json POST /v1beta/models/{model}:generateContent","description":"Generates synchronous text or multimodal output with Gemini.","href":"/en/api-reference/endpoints/gemini/image"}]}]},{"group":"Seedance","pages":[{"group":"Video","pages":[{"title":"/api/v3/contents/generations/tasks","sidebarTitle":"Create video generation task","openapi":"en/api-reference/openapi.json POST /api/v3/contents/generations/tasks","href":"/en/api-reference/endpoints/seedance/create-task"},{"title":"/api/v3/contents/generations/tasks/{task_id}","sidebarTitle":"Get video generation task","openapi":"en/api-reference/openapi.json GET /api/v3/contents/generations/tasks/{task_id}","description":"Query the status and result of a generation task by ID.","href":"/en/api-reference/endpoints/seedance/get-task"}]},{"group":"Asset library","pages":[{"title":"Asset library authentication and conventions","sidebarTitle":"Authentication and conventions","href":"/en/api-reference/endpoints/seedance/asset-overview"},{"title":"CreateAssetGroup","sidebarTitle":"Create asset group","href":"/en/api-reference/endpoints/seedance/create-asset-group"},{"title":"GetAssetGroup","sidebarTitle":"Get asset group","href":"/en/api-reference/endpoints/seedance/get-asset-group"},{"title":"ListAssetGroups","sidebarTitle":"List asset groups","href":"/en/api-reference/endpoints/seedance/list-asset-groups"},{"title":"UpdateAssetGroup","sidebarTitle":"Update asset group","href":"/en/api-reference/endpoints/seedance/update-asset-group"},{"title":"DeleteAssetGroup","sidebarTitle":"Delete asset group","href":"/en/api-reference/endpoints/seedance/delete-asset-group"},{"title":"CreateAsset","sidebarTitle":"Import asset","href":"/en/api-reference/endpoints/seedance/create-asset"},{"title":"GetAsset","sidebarTitle":"Get asset","href":"/en/api-reference/endpoints/seedance/get-asset"},{"title":"ListAssets","sidebarTitle":"List assets","href":"/en/api-reference/endpoints/seedance/list-assets"},{"title":"UpdateAsset","sidebarTitle":"Update asset","href":"/en/api-reference/endpoints/seedance/update-asset"},{"title":"DeleteAsset","sidebarTitle":"Delete asset","href":"/en/api-reference/endpoints/seedance/delete-asset"},{"title":"CreateVisualValidateSession","sidebarTitle":"Create liveness session","href":"/en/api-reference/endpoints/seedance/create-visual-validate-session"},{"title":"GetVisualValidateResult","sidebarTitle":"Get liveness result","href":"/en/api-reference/endpoints/seedance/get-visual-validate-result"}]}]}]},{"group":"Usage Examples","pages":[{"group":"Basic chat","pages":[{"title":"OpenAI basic chat example","href":"/en/api-reference/examples/basic-chat-openai"},{"title":"Claude basic chat example","href":"/en/api-reference/examples/basic-chat-claude"},{"title":"Gemini basic chat example","href":"/en/api-reference/examples/basic-chat-gemini"}]},{"group":"Responses API","pages":[{"title":"OpenAI Responses API example","href":"/en/api-reference/examples/responses-api-openai"}]},{"group":"Streaming chat","pages":[{"title":"OpenAI streaming chat example","href":"/en/api-reference/examples/streaming-chat-openai"},{"title":"Claude streaming chat example","href":"/en/api-reference/examples/streaming-chat-claude"},{"title":"Gemini streaming chat example","href":"/en/api-reference/examples/streaming-chat-gemini"}]},{"group":"Structured output","pages":[{"title":"OpenAI structured output example","href":"/en/api-reference/examples/structured-output-openai"},{"title":"Claude structured output example","href":"/en/api-reference/examples/structured-output-claude"},{"title":"Gemini structured output example","href":"/en/api-reference/examples/structured-output-gemini"}]},{"group":"Reasoning","pages":[{"title":"OpenAI reasoning example","href":"/en/api-reference/examples/reasoning-openai"},{"title":"Claude reasoning example","href":"/en/api-reference/examples/reasoning-claude"},{"title":"Gemini reasoning example","href":"/en/api-reference/examples/reasoning-gemini"}]},{"group":"Tool calling","pages":[{"title":"OpenAI tool calling example","href":"/en/api-reference/examples/tool-calling-openai"},{"title":"Claude tool calling example","href":"/en/api-reference/examples/tool-calling-claude"},{"title":"Gemini tool calling example","href":"/en/api-reference/examples/tool-calling-gemini"}]},{"group":"Image generation","pages":[{"title":"OpenAI image generation and editing examples","href":"/en/api-reference/examples/image-generation-openai"},{"title":"Claude image generation example","href":"/en/api-reference/examples/image-generation-claude"},{"title":"Gemini image generation example","href":"/en/api-reference/examples/image-generation-gemini"}]},{"group":"Video generation","pages":[{"title":"Claude video generation example","href":"/en/api-reference/examples/video-generation-claude"},{"title":"Seedance video generation example","href":"/en/api-reference/examples/video-generation-seedance"}]},{"group":"Multimodal chat","pages":[{"title":"OpenAI multimodal chat example","href":"/en/api-reference/examples/multimodal-chat-openai"},{"title":"Claude multimodal chat example","href":"/en/api-reference/examples/multimodal-chat-claude"},{"title":"Gemini multimodal chat example","href":"/en/api-reference/examples/multimodal-chat-gemini"}]},{"group":"Extended parameters (model_extra)","pages":[{"title":"OpenAI extended-parameters example","href":"/en/api-reference/examples/model-extra-openai"},{"title":"Claude extended-parameters example","href":"/en/api-reference/examples/model-extra-claude"},{"title":"Gemini extended-parameters example","href":"/en/api-reference/examples/model-extra-gemini"}]}]}]},{"tab":"AI Coding","pages":[{"title":"AI Coding","href":"/en/coding-plan/ai-tools/codex"}]}]}]},"basePath":"","title":"/api/v3/contents/generations/tasks - docs.apigo.ai","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}