doubao-seedance-1-5-pro

本文详细介绍 doubao-seedance-1-5-pro-251215 模型的核心 API（异步提交任务、查询任务状态），包含接口地址、输入输出参数、请求示例、响应示例及输入对象详细说明，为接口调用提供清晰、规范的指引。

1. 认证方式

所有接口均采用 API Key 认证，需在请求头中携带 Authorization 字段，格式如下：

Authorization: \<YOUR\_API\_KEY\>

说明：将 \<YOUR\_API\_KEY\> 替换为您实际的 API Key，即可完成身份认证，获取接口调用权限。

2. 异步提交任务接口

该接口用于提交 doubao-seedance-1-5-pro-251215 模型的视频生成异步任务，需传入模型名称、输入内容（文本、图片或样片信息）及相关配置参数，提交成功后返回任务唯一标识，用于后续查询任务状态及生成结果。

2.1 接口地址

https://api.modelverse.cn/v1/tasks/submit

2.2 输入参数

参数	类型	是否必选	描述
model	string	是	模型名称，固定填写：doubao-seedance-1-5-pro-251215
input.content	object[]	是	输入给模型生成视频的信息对象，支持三种对象类型：文本信息、图片信息、样片信息；具体说明见下方「输入input.content对象介绍」。
parameters.execution_expires_after	int	否	任务超时阈值，指定任务提交后的过期时间（单位：秒），默认值 172800 秒（即 48 小时），取值范围：[3600，259200]。
parameters.generate_audio	boolean	否	控制生成的视频是否包含与画面同步的声音，默认 false；true：模型输出的视频包含同步音频；false：模型输出的视频为无声视频。
parameters.draft	boolean	否	控制是否开启样片模式，默认 false；true：开启样片模式，生成一段预览视频，快速验证场景结构、镜头调度、主体动作与 prompt 意图是否符合预期，消耗 token 数较正常视频更少，使用成本更低；false：关闭样片模式，正常生成一段视频。
parameters.resolution	string	否	视频分辨率，默认 720p；支持 480p、720p、1080p；注意：样片模式只支持 480p。
parameters.ratio	string	否	生成视频的宽高比例，支持：16:9、4:3、1:1、3:4、9:16、21:9、adaptive；默认是 adaptive，智能选择最合适的宽高比。
parameters.duration	int	否	生成视频时长（秒）：4~12 秒，默认为 5。
parameters.seed	int	否	随机数种子，范围 [0, 2147483647]。
parameters.camera_fixed	boolean	否	是否固定摄像头，默认 false；true：固定摄像头；false：不固定摄像头。
parameters.watermark	boolean	否	生成视频是否包含水印，默认 false；false：不含水印；true：含有水印。
parameters.service_tier	string	否	指定处理本次请求的服务等级类型，默认 default；default：在线推理模式，适合对推理时效性要求较高的场景；flex：离线推理模式，适合对推理时延要求不高的场景。

2.3 输入input.content对象介绍

样片信息对象是通过样片生成视频，不支持与文本信息、图片信息对象混用。

2.3.1 文本信息对象

参数	类型	是否必选	描述
content.type	string	是	输入内容的类型，此处固定为 text。
content.text	string	是	输入给模型的文本内容，描述期望生成的视频，支持中英文；建议不超过500字。

2.3.2 图片信息对象

参数	类型	是否必选	描述
content.type	string	是	输入内容的类型，此处固定为 image_url；支持图片URL或图片 Base64 编码。
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	否	图片的位置或用途；- 1个image_url对象：字段role可不填，或字段role为：first_frame；- 2个image_url对象时：字段role必填，首帧图片对应的字段role为：first_frame，尾帧图片对应的字段role为：last_frame。

2.3.3 样片信息对象

参数	类型	是否必选	描述
content.type	string	是	输入内容的类型，此处固定为 draft_task。
content.draft_task	object	是	输入给模型的样片任务。
content.draft_task.id	string	是	样片任务 ID。

2.4 请求示例（curl）

如果您使用 Windows 系统，建议使用 Postman 或其他 API 调用工具，避免命令行调用出现兼容问题。

curl -v 'https://api.modelverse.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-1-5-pro-251215",
    "input": {
        "content": [
        {
            "type": "text",
            "text": "让他跑起来。"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg"
            },
            "role": "first_frame"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg"
            },
            "role": "last_frame"
        }
      ]
    },
    "parameters": {
      "generate_audio": true,
      "duration": 5,
      "execution_expires_after": 3600,
      "generate_audio": true,
      "resolution": "720p",
      "camera_fixed": false,
      "watermark": false,
      "draft": false
    }
  }'

2.5 输出参数

参数	类型	描述
output.task_id	string	异步任务的唯一标识，用于后续查询任务状态及获取生成结果。
request_id	string	本次请求的唯一标识，用于问题排查时定位具体请求记录。

2.6 响应示例

{
  "output": {
    "task_id": "task_id"
  },
  "request_id": "request_id"
}

3. 查询任务状态接口

该接口用于查询已提交的视频生成异步任务的执行状态、生成结果、任务耗时及 token 消耗等信息，需传入异步提交任务时返回的 task_id 作为查询标识。

3.1 接口地址

https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>

说明：将 \<task\_id\> 替换为异步提交任务接口返回的实际 task_id，即可发起查询。

3.2 输入参数

参数	类型	是否必选	描述
task_id	string	是	异步任务的唯一标识，由异步提交任务接口返回，用于定位查询具体任务。

3.3 请求示例（curl）

curl --location 'https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>' \
--header 'Authorization: <YOUR_API_KEY>'

3.4 输出参数

参数	类型	描述
output.task_id	string	异步任务的唯一标识，与查询时传入的 task_id 一致。
output.task_status	string	任务状态，可选值：Pending（待处理）、Running（执行中）、Success（成功）、Failure（失败）、Expired（已过期）。
output.urls	array	视频结果的 URL 列表，仅当 task_status 为 Success 时返回，可通过该 URL 下载生成的视频。
output.submit_time	integer	任务提交时间戳（单位：秒）。
output.finish_time	integer	任务完成时间戳（单位：秒），仅当 task_status 为 Success、Failure 或 Expired 时返回。
output.error_message	string	任务失败时返回的错误信息，仅当 task_status 为 Failure 时返回，用于排查失败原因。
usage.duration	integer	视频时长（秒）。
usage.completion_tokens	integer	模型输出视频花费的 token 数量。
usage.total_tokens	integer	本次请求消耗的总 token 数量；视频生成模型不统计输入 token，输入 token 为 0，故 total_tokens=completion_tokens。
request_id	string	本次查询请求的唯一标识，用于问题排查。

3.5 响应示例

3.5.1 成功响应示例

{
    "output": {
        "task_id": "xxxxxxx",
        "task_status": "Success",
        "urls": ["http://xxxxxxxx/xx.mp4"],
        "submit_time": 1768460826,
        "finish_time": 1768460932
    },
    "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900,
        "duration": 5
    },
    "request_id": ""
}

3.5.2 失败响应示例

{
  "output": {
    "task_id": "xxxxxxx",
    "task_status": "Failure",
    "submit_time": 1756959000,
    "finish_time": 1756959019,
    "error_message": "error_message"
  },
  "usage": {
      "completion_tokens": 0,
      "total_tokens": 0,
    "duration": 5
  },
  "request_id": ""
}