doubao-seedance-2-5

文图生视频模型

异步提交任务

接口

https://airouter.xincache.cn/v1/tasks/submit

输入

参数	类型	是否必选	描述
model	string	是	模型名称，此处为 `doubao-seedance-2-5-260628`。
input.content	object[]	是	输入给模型生成视频的信息对象。参考协议明确给出四种对象结构：文本信息、图片信息、参考视频信息、参考音频信息。参考下方 content 介绍。
parameters.execution_expires_after	int	否	任务超时阈值。指定任务提交后的过期时间（单位：秒），默认值 `172800` 秒，即 48 小时。取值范围： `[3600, 259200]`。
parameters.generate_audio	boolean	否	控制生成的视频是否包含与画面同步的声音，默认 `false`。 `true` ：模型输出的视频包含同步音频。 `false` ：模型输出的视频为无声视频。
parameters.resolution	string	否	视频分辨率，支持 `480p`、 `720p` ，默认 `720p` 。样片模式仅支持 `480p`。
parameters.ratio	string	否	生成视频的宽高比例，支持： `16:9`、 `4:3`、 `1:1`、 `3:4`、 `9:16`、 `21:9`、 `adaptive` 。默认 `adaptive` ，智能选择最合适的宽高比。
parameters.duration	int	否	生成视频时长（秒）： `4~30` 秒，默认 5 秒。
parameters.seed	int	否	随机数种子，范围 `[0, 2147483647]`。
parameters.camera_fixed	boolean	否	是否固定摄像头，默认 `false`。 `true` ：固定摄像头。 `false` ：不固定摄像头。
parameters.watermark	boolean	否	生成视频是否包含水印，默认 `false`。 `true` ：包含水印。 `false` ：不包含水印。
parameters.callback_url	string	否	任务状态变化的回调 URL。视频任务状态变化时，系统会向该 URL 发送 POST 请求。
parameters.seedance_tools	object[]	否	Seedance 官方工具列表。开启后模型可在生成过程中调用对应工具，目前仅支持联网搜索。
parameters.seedance_tools[].type	string	是	工具类型，目前仅支持 `web_search`。

输入 input.content 对象介绍

参考协议还提及样片模式，但未定义对应的 content 对象字段。样片模式不得与文本信息或图片信息对象混用。

文本信息对象

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

图片信息对象

参数	类型	是否必选	描述
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` 对象时可不填，或设为 `first_frame` 。2 个 `image_url` 对象时必填：首帧为 `first_frame` ，尾帧为 `last_frame` 。参考图为 `reference_image`。

参考视频信息对象

参数	类型	是否必选	描述
content.type	string	是	输入内容的类型，此处应为 `video_url`。
content.video_url	object	是	输入给模型的参考视频对象。
content.video_url.url	string	是	参考视频 URL，请确保 URL 可被访问。
content.role	string	是	固定为 `reference_video`。

参考音频信息对象

参数	类型	是否必选	描述
content.type	string	是	输入内容的类型，此处应为 `audio_url`。
content.audio_url	object	是	输入给模型的参考音频对象。
content.audio_url.url	string	是	参考音频 URL，请确保 URL 可被访问。
content.role	string	是	固定为 `reference_audio`。

请求示例

⚠️ 如果您使用 Windows 系统，建议使用 Postman 或其他 API 调用工具。

curl -v 'https://airouter.xincache.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedance-2-5-260628",
    "input": {
      "content": [
        {
          "type": "text",
          "text": "让他跑起来。"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://static.xinnet.com/xinnetmodel/xinnet-maxcot.jpg"
          },
          "role": "first_frame"
        },
        {
          "type": "video_url",
          "video_url": {
            "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
          },
          "role": "reference_video"
        },
        {
          "type": "audio_url",
          "audio_url": {
            "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
          },
          "role": "reference_audio"
        }
      ]
    },
    "parameters": {
      "execution_expires_after": 3600,
      "generate_audio": true,
      "resolution": "720p",
      "ratio": "adaptive",
      "duration": 30,
      "camera_fixed": false,
      "watermark": false,
      "callback_url": "https://example.com/callback",
      "seedance_tools": [
        {
          "type": "web_search"
        }
      ]
    }
  }'

输出

参数	类型	描述
output.task_id	string	异步任务的唯一标识
request_id	string	请求的唯一标识

响应示例

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

查询任务状态

接口

https://airouter.xincache.cn/v1/tasks/status?task_id=<task_id>

请求示例

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

输出

参数	类型	描述
output.task_id	string	异步任务的唯一标识
output.task_status	string	任务状态： `Pending`、 `Running`、 `Success`、 `Failure`、 `Expired`
output.urls	array	视频结果的 URL 列表
output.submit_time	integer	任务提交时间戳
output.finish_time	integer	任务完成时间戳
output.error_message	string	失败时返回的错误信息
usage.duration	integer	视频时长（秒）
usage.completion_tokens	integer	模型输出视频花费的 token 数量
usage.total_tokens	integer	本次请求消耗的总 token 数量。视频生成模型不统计输入 token，输入 token 为 0，故 `total_tokens=completion_tokens`。
request_id	string	请求的唯一标识

响应示例（成功）

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

响应示例（失败）

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

取消任务

仅可取消并删除尚未开始运行的任务。若任务正在运行，则无法取消，接口返回 HTTP 500。

接口

https://airouter.xincache.cn/v1/tasks/cancel?task_id=<task_id>

输入

参数	类型	是否必选	描述
task_id	string	是	需要取消的异步任务标识，由 `/v1/tasks/submit` 返回。

请求示例

curl --location 'https://airouter.xincache.cn/v1/tasks/cancel?task_id=<task_id>' \
--header 'Authorization: <YOUR_API_KEY>'

输出

参数	类型	描述
deleted	boolean	是否成功取消并删除任务
id	string	被取消的任务标识
object	string	对象类型，固定为 `video.deleted`

响应示例（成功）

{
  "deleted": true,
  "id": "task_id",
  "object": "video.deleted"
}

Last modified: 13 August 2026