MaaS_Seedance 接口文档

请求协议

Http

参数名	类型	描述
anthorization	string	鉴权

创建任务

请求URL

https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks

请求方法

POST

请求参数

属性名	类型	必需/可选	描述
model	string	必选	您需要调用的模型的 ID （Model ID）
content	object	必选	输入给模型，生成视频的信息，支持文本信息和图片信息。
content.type	string	必选	输入内容的类型text 文本内容image_url 图片信息draft_task 样片TaskId
content.text	string	必选	输入给模型的文本内容，描述期望生成的视频，包括：文本提示词（必填）：支持中英文。建议不超过500字。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成视频缺失部分元素。提示词的更多使用技巧请参见 Seedance 提示词指南。参数（选填）：在文本提示词后追加--[parameters]，控制视频输出的规格
content.draft_task	object	(content.Type为draft_task时，必选)	样片任务 ID
content.image_url	object	必选	输入给模型的图片对象。
content.image_url.url	string	必选	图片信息，可以是图片URL或图片 Base64 编码。图片URL：请确保图片URL可被访问。 Base64编码：请遵循此格式data:image/<图片格式>;base64,<Base64编码>，注意 <图片格式> 需小写，如 data:image/png;base64,{base64_image}。
content.role	string	条件必填	首帧图生视频支持模型：MaaS_Seedance_1.0_pro_fast、MaaS_Seedance_1.0_pro、MaaS_Seedance_1.0_lite_i2v 字段role取值：需要传入1个image_url对象，且字段role可不填，或字段role为：first_frame 首尾帧图生视频支持模型：MaaS_Seedance_1.5_pro、MaaS_Seedance_1.0_pro_fast、MaaS_Seedance_1.0_pro、MaaS_Seedance_1.0_lite_i2v 字段role取值：需要传入2个image_url对象，且字段role必填。首帧图片对应的字段role为：first_frame 尾帧图片对应的字段role为：last_frame 参考图生视频支持模型：MaaS_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：不返回生成视频的尾帧图像。
frames	integer	可选	frames和duration(dur)二选一MaaS_Seedance_1.5_pro 不支持该参数
service_tier	string	可选	指定处理本次请求的服务等级类型，枚举值：default：在线推理模式，RPM 和并发数配额较低，适合对推理时效性要求较高的场景。flex：离线推理模式，TPD 配额更高，价格为在线推理的 50%，适合对推理时延要求不高的场景。平台暂时不支持离线推理模式。
execution_expires_after	integer	可选	默认值 172800 （秒），即48小时取值范围：[3600，259200]
generate_audio	boolean	可选	默认值truetrue：模型输出的视频包含同步音频。MaaS_Seedance_1.5_pro 能够基于文本提示词与视觉内容，自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内，以优化音频生成效果。例如：男人叫住女人说：“你记住，以后不可以用手指指月亮。”false：模型输出的视频为无声视频。仅在MaaS_Seedance_1.5_pro中支持
draft	boolean	可选	默认值falsetrue: 开启样片模式，生成一段预览视频，快速验证场景结构、镜头调度、主体动作与 prompt 意图是否符合预期。消耗 token 数较正常视频更少，使用成本更低。仅支持480p分辨率（使用其他分辨率会报错），不支持返回尾帧功能，不支持离线推理功能。false: 正常生成视频

请求示例

文生视频

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

图生视频-首帧

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": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动  --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://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": "一只蓝绿精卫鸟变成人形 --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://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": "老爷爷在咖啡馆里，端起咖啡杯，画面风格卡通、清新  --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******-****"
}

样片模式示例

Step1: 生成样片

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": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"
        },
        {
            "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
}'

在接口返回中获取样片taskId

{
  "id": "cgt-2026******-AAAAA"
}

Step2: 查询样片状态

// $ID即刚刚获取的taskID，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: 当样片生成成功后，基于样片视频生成正式视频

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

在接口返回中获取正式视频taskId

{
  "id": "cgt-2026******-BBBBB"
}

Step4: 获得正式视频生成结果

// $ID即刚刚获取的taskID，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"

查询任务（单个）

请求URL

https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks/{id}

请求方法

GET

请求示例

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"

响应示例

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

查询视频生成任务列表

请求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}

请求方法

GET

请求示例

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"

响应示例

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

取消或删除视频生成任务

请求URL

https://genaiapi.cloudsway.net/v1/ai/{Your EndpointPath}/seedance/contents/generations/tasks/{id}

请求方法

DELETE

请求示例

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"

本接口无返回参数。