Skip to content

MaaS_Seedance Model Interface Documentation

Create Video Generation Task API

POST {endpointPath}/seedance/contents/generations/tasks

Request Parameters

Attribute Name Type Required/Optional Description
content object Required Input information into the model to generate videos, supporting both text and image information.
content.type string Required Input content type: text for textual content, image_url for image information
content.text string Required The text content inputted to the model describes the video you wish to generate, including: Text prompts (required): Supports both Chinese and English. It is recommended to keep it under 500 words. Excessive words may disperse the information, causing the model to ignore some details and focus only on key points, which may result in missing elements in the video. For more tips on using prompts, please refer to the Seedance Prompt Guide. Parameters (optional): Append --[parameters] after the text prompt to control the video output specifications. For details, see Seedance official website Model Text Commands (optional).
content.image_url object Required The image object input to the model.
content.image_url.url string Required Image information can be either an image URL or a Base64-encoded image. Image URL: Please ensure that the image URL is accessible. Base64 encoding: Please follow this format data:image/;base64,, and note that must be in lowercase, for example, data:image/png;base64,{base64_image}.
content.role string Condition required First-frame image to videoSupported models: doubao-seedance-pro, doubao-seedance-1-0-lite-i2vField 'role' values: You need to pass 1 image_url object. The 'role' field can be left empty, or set to: first_frame.First and last frame image to videoSupported models: doubao-seedance-pro, doubao-seedance-1-0-lite-i2vField 'role' values: You need to pass 2 image_url objects, and the 'role' field is required. The 'role' field for the first frame image should be: first_frame, and for the last frame image: last_frame.Reference image to videoSupported models: doubao-seedance-1-0-lite-i2vField 'role' values: You need to pass 1 to 4 image_url objects, and the 'role' field is required. The 'role' field for each reference image should be: reference_image
callback_url string Optional Fill in the callback notification address for the result of this generation task. When there is a status change in the video generation task, Ark will push a POST request to this address.
return_last_frame Boolean Optional Default value is false. true: Returns the last frame image of the generated video. The format of the last frame image is PNG, with the same width and height in pixels as the generated video, and without a watermark. You can obtain the last frame image of the video through the video generation task interface. false: Does not return the last frame image of the generated video.

Request Body Example

Text-to-Video

curl -X POST https://{endpointPath}/seedance/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "MaaS_Seedance_1.0_pro",
    "content": [
        {
            "type": "text",
            "text": "Multiple shots. A detective enters a dimly lit room. He inspects the clues on the table, picking up an item from it. The camera shifts to him deep in thought. --ratio 16:9"
        }
    ]
}'

Image-to-Video - First Frame

curl -X https://{endpointPath}/seedance/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "MaaS_Seedance_1.0_pro",
    "content": [
        {
            "type": "text",
            "text": "A girl is holding a fox, the girl opens her eyes and looks gently at the camera, the fox hugs her amicably, the camera slowly pulls back, 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://{endpointPath}/seedance/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "MaaS_Seedance_1.0_lite_i2v",
    "content": [
         {
            "type": "text",
            "text": "A blue-green Jingwei bird transforms into 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 image

curl -X POST https://{endpointPath}/seedance/contents/generations/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "MaaS_Seedance_1.0_lite_i2v",
    "content": [
         {
            "type": "text",
            "text": "The elderly man is in the café, holding up a coffee cup; the scene is in a cartoon and fresh style --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******-****"
}

Query Video Generation Task API

GET {endpointPath}/seedance/contents/generations/tasks/{id}

Request Body Example

curl -X GET "https://{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

GET {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 Body Example

curl -X GET "https://{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 the video generation task

DELETE {endpointPath}/seedance/contents/generations/tasks/{id}

Request Body Example

curl -X DELETE "https://{endpointPath}/seedance/contents/generations/tasks/$ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY"

This interface has no return parameters.