跳转至

MaaS_Seedance模型接口文档接口

创建视频生成任务 API

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

请求参数

属性名 类型 必需/可选 描述
content object 必选 输入给模型，生成视频的信息，支持文本信息和图片信息。
content.type string 必选 输入内容的类型text 文本内容image_url 图片信息
content.text string 必选 输入给模型的文本内容，描述期望生成的视频，包括：文本提示词（必填）：支持中英文。建议不超过500字。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成视频缺失部分元素。提示词的更多使用技巧请参见 Seedance 提示词指南。参数（选填）：在文本提示词后追加--[parameters]，控制视频输出的规格。
content.image_url object 必选 输入给模型的图片对象。
content.image_url.url string 必选 图片信息，可以是图片URL或图片 Base64 编码。图片URL：请确保图片URL可被访问。Base64编码：请遵循此格式data:image/<图片格式>;base64,，注意 <图片格式> 需小写，如 data:image/png;base64,{base64_image}。
content.role string 条件必填 首帧图生视频支持模型：doubao-seedance-pro、doubao-seedance-1-0-lite-i2v
字段role取值：需要传入1个image_url对象，且字段role可不填，或字段role为：first_frame首尾帧图生视频
支持模型：doubao-seedance-pro、doubao-seedance-1-0-lite-i2v
字段role取值：需要传入2个image_url对象，且字段role必填。首帧图片对应的字段role为：first_frame尾帧图片对应的字段role为：last_frame参考图生视频
支持模型：doubao-seedance-1-0-lite-i2v
字段role取值：需要传入1～4个image_url对象，且字段role必填。每张参考图片对应的字段role均为：reference_image
callback_url string 可选 填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，方舟将向此地址推送 POST 请求。
return_last_frame Boolean 可选 默认值false。true：返回生成视频的尾帧图像。尾帧图像的格式为 png，宽高像素值与生成的视频一致，无水印。您可通过查询视频生成任务接口获取视频的尾帧图像。false：不返回生成视频的尾帧图像。

请求体示例

文生视频

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": "多个镜头。一名侦探进入一间光线昏暗的房间。他检查桌上的线索，手里拿起桌上的某个物品。镜头转向他正在思索。 --ratio 16:9"
        }
    ]
}'

图生视频-首帧

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": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动  --ratio adaptive  --dur 5"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
            }
        }
    ]
}'

首尾帧

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": "一只蓝绿精卫鸟变成人形 --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"
        }
    ]
}'

参考图

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": "老爷爷在咖啡馆里，端起咖啡杯，画面风格卡通、清新  --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"
        }
    ]
}'

响应示例

{
  "id": "cgt-2025******-****"
}

查询视频生成任务 API

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

请求体示例

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

响应示例

{
  "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
}

查询视频生成任务列表

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}

请求体示例

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"

响应示例

{
  "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
    }
  ]
}

取消或删除视频生成任务

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

请求体示例

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

本接口无返回参数。