MaaS_Seedance API
Request Protocol
Http
Header
| Parameter Name | Type | Description |
|---|---|---|
| anthorization | string | Authentication |
Create Task
Request URL
https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks
Request Method
POST
Request Parameters
| Attribute Name | Type | Required/Optional | Description |
|---|---|---|---|
| model | string | Required | ID of the model you need to call (Model ID) |
| content | object | Required | Information input to the model for video generation, supporting text information and image information. |
| content.type | string | Required | Type of input content: - text: Text content - image_url: Image information - draft_task: Draft TaskId |
| content.text | string | Required | Text content input to the model, describing the expected video to be generated, including: - Text prompt (required): Supports Chinese and English. It is recommended not to exceed 500 words. Excessively long text may lead to scattered information, and the model may ignore details and only focus on key points, resulting in missing elements in the video. For more usage skills of prompts, please refer to the Seedance Prompt Guide. - Parameters (optional): Append --[parameters] after the text prompt to control the specifications of the video output |
| content.draft_task | object | (Required when content.Type is draft_task) | Draft task ID |
| content.image_url | object | Required | Image object input to the model. |
| content.image_url.url | string | Required | Image information, which can be an image URL or image Base64 encoding.
|
| content.role | string | Conditionally Required | First-frame image to video
|
| callback_url | string | Optional | Fill in the callback notification address for the result of this generation task. When the status of the video generation task changes, Ark will send a POST request to this address. |
| return_last_frame | Boolean | Optional | Default value: false. - true: Return the last frame image of the generated video. The format of the last frame image is png, with the same width and height pixels as the generated video, and no watermark. You can obtain the last frame image of the video through the query video generation task interface. - false: Do not return the last frame image of the generated video. |
| frames | integer | Optional | Choose one between frames and duration (dur). MaaS_Seedance_1.5_pro does not support this parameter |
| service_tier | string | Optional | Specify the service level type for processing this request. Enumerated values: - default: Online inference mode, with lower RPM and concurrency quotas, suitable for scenarios with high requirements for inference timeliness. - flex: Offline inference mode, with higher TPD quotas and 50% of the price of online inference, suitable for scenarios with low requirements for inference latency. The platform does not support offline inference mode temporarily. |
| execution_expires_after | integer | Optional | Default value: 172800 (seconds), i.e., 48 hours. Value range: [3600, 259200] |
| generate_audio | boolean | Optional | Default value: true. - true: The video output by the model contains synchronized audio. MaaS_Seedance_1.5_pro can automatically generate matching human voices, sound effects, and background music based on text prompts and visual content. It is recommended to place dialogue parts in double quotes to optimize audio generation effects. For example: The man stopped the woman and said: "Remember, you must not point at the moon with your finger in the future." - false: The video output by the model is a silent video. Only supported in MaaS_Seedance_1.5_pro |
| draft | boolean | Optional | Default value: false. - true: Enable draft mode to generate a preview video, quickly verifying whether the scene structure, lens scheduling, subject actions, and prompt intent meet expectations. It consumes fewer tokens than normal videos and has lower usage costs. Only supports 480p resolution (an error will be reported when using other resolutions), does not support the function of returning the last frame, and does not support the offline inference function. - false: Generate video normally |
Request Examples
Text to Video
curl -X POST "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "Multiple shots. A detective enters a dimly lit room. He checks the clues on the table and picks up an item from the table. The camera pans to him thinking. --ratio 16:9"
}
]
}'
Image to Video - First Frame
curl -X POST "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{
"type": "text",
"text": "A girl is holding a fox. The girl opens her eyes, looks gently at the camera, and the fox cuddles up friendly. The camera slowly pulls back, and the girl's hair is blown by the wind --ratio adaptive --dur 5"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
}
}
]
}'
First and Last Frames
curl -X POST "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "doubao-seedance-1-0-lite-i2v-250428",
"content": [
{
"type": "text",
"text": "A blue-green Jingwei bird transforms into a human form --rs 720p --dur 5 --cf false"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_first_frame.png"
},
"role": "first_frame"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_last_frame.png"
},
"role": "last_frame"
}
]
}'
Reference Images
curl -X POST "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"model": "doubao-seedance-1-0-lite-i2v-250428",
"content": [
{
"type": "text",
"text": "An elderly man is in a café, picking up a coffee cup. The picture style is cartoonish and fresh --rs 720p --dur 5 --rt 16:9 --seed 12345 --wm true"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png"
},
"role": "reference_image"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png"
},
"role": "reference_image"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
},
"role": "reference_image"
}
]
}'
Response Example
{
"id": "cgt-2025******-****"
}
Draft Mode Example
Step1: Generate Draft Video
curl -X POST "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "text",
"text": "A girl is holding a fox. The girl opens her eyes, looks gently at the camera, and the fox cuddles up friendly. The camera slowly pulls back, and the girl's hair is blown by the wind"
},
{
"type": "image_url",
"image_url": {
"url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
}
}
],
"seed": 20,
"duration": 6,
"draft": true
}'
Obtain the draft taskId from the interface response
{
"id": "cgt-2026******-AAAAA"
}
Step2: Query Draft Status
// $ID is the taskID just obtained, cgt-2026******-AAAAA
curl -X GET "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks/$ID" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY"
Step3: Generate Official Video Based on Draft Video After Successful Draft Generation
curl -X POST "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{
"type": "draft_task",
"draft_task": {"id": "cgt-2026******-AAAAA"}
}
],
"watermark": false,
"resolution": "720p",
"return_last_frame": true,
"service_tier": "default"
}'
Obtain the official video taskId from the interface response
{
"id": "cgt-2026******-BBBBB"
}
Step4: Get the Result of Official Video Generation
// $ID is the taskID just obtained, cgt-2026******-BBBBB
curl -X GET "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks/$ID" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY"
Query Task (Single)
Request URL
https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks/{id}
Request Method
GET
Request Example
curl -X GET "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks/$ID" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY"
Response Example
{
"id": "cgt-2025******-****",
"model": "doubao-seedance-1-0-pro-250528",
"status": "succeeded",
"content": {
"video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-1-0-pro/****.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTY****%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250331T095113Z&X-Tos-Expires=86400&X-Tos-Signature=***&X-Tos-SignedHeaders=host"
},
"seed": 10,
"resolution": "720p",
"duration": 5,
"ratio": "16:9",
"framespersecond": 24,
"usage": {
"completion_tokens": 108900,
"total_tokens": 108900
},
"created_at": 1743414619,
"updated_at": 1743414673
}
Query Video Generation Task List
Request URL
https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks?page_num={page_num}&page_size={page_size}&filter.status={filter.status}&filter.task_ids={filter.task_ids}&filter.model={filter.model}
Request Method
GET
Request Example
curl -X GET "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks?page_size=3&filter.status=succeeded&" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY"
Response Example
{
"total": 3,
"items": [
{
"id": "cgt-2025******-****",
"model": "doubao-seedance-1-0-pro-250528",
"status": "succeeded",
"content": {
"video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-1-0-pro/****.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTY****%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250331T095113Z&X-Tos-Expires=86400&X-Tos-Signature=***&X-Tos-SignedHeaders=host"
},
"seed": 10,
"resolution": "720p",
"duration": 5,
"ratio": "16:9",
"framespersecond": 24,
"usage": {
"completion_tokens": 108900,
"total_tokens": 108900
},
"created_at": 1743414619,
"updated_at": 1743414673
},
{
"id": "cgt-2025******-****",
"model": "doubao-seedance-1-0-pro-250528",
"status": "succeeded",
"content": {
"video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx"
},
"seed": 23,
"resolution": "720p",
"duration": 5,
"ratio": "16:9",
"framespersecond": 24,
"usage": {
"completion_tokens": 82280,
"total_tokens": 82280
},
"created_at": 1743406900,
"updated_at": 1743406940
},
{
"id": "cgt-2025******-****",
"model": "doubao-seedance-1-0-pro-250528",
"status": "succeeded",
"content": {
"video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx"
},
"seed": 4,
"resolution": "720p",
"duration": 5,
"ratio": "16:9",
"framespersecond": 24,
"usage": {
"completion_tokens": 82280,
"total_tokens": 82280
},
"created_at": 1743406900,
"updated_at": 1743406946
}
]
}
Cancel or Delete Video Generation Task
Request URL
https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks/{id}
Request Method
DELETE
Request Example
curl -X DELETE "https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks/$ID" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY"
This interface has no return parameters.
```