Seedance 2.0 Fast 视频生成

字节 Seedance 2.0 Fast 视频生成模型，支持文生视频与图生视频，异步任务模式。

接入地址

线路	Base URL
官网（推荐）	`https://iliu.ai`
海外直连	`https://api.xinliu.one`

Header

参数名	是否必填	说明
Authorization	是	`Bearer 你的令牌`
Content-Type	是	`application/json`，本接口仅接受 JSON 请求体，不支持 multipart/form-data
Idempotency-Key	否	幂等键，用于重复提交去重，建议携带唯一值

请求体（JSON）

参数	类型	必填	说明
model	string	是	固定为 `seedance-2.0-fast`
prompt	string	是	视频描述提示词
seconds	string	是	时长（秒），`5`-`15` 整数，字符串格式，例如 `"5"`；实际时长以本字段为准
duration	int	否	不控制实际时长，时长请使用 `seconds` 字段
images	array	图生视频必填	参考图 URL 数组，必须是公网可访问的 HTTPS 地址
metadata	object	否	仅图生视频任务支持；文生视频任务请勿携带本字段，否则任务会失败
metadata.ratio	string	否	画幅，可用值：`16:9`（默认）、`9:16`、`1:1`、`4:3`、`3:4`、`21:9`；仅图生视频任务生效
metadata.resolution	string	否	分辨率，可用值：`720p`（默认）

文生视频任务不支持 metadata 字段，输出固定为 16:9 / 720p（1280x720）。需要其他画幅时，请使用图生视频并通过 metadata.ratio 设置。

提交也兼容 POST /v1/video/generations 路径，请求体与返回结构完全一致。

curl 示例

文生视频（不携带 metadata）：

图生视频（参考图必须是公网可访问的 HTTPS 地址）：

prompt 中可以用 @Image1、@Image2 按顺序指代 images 数组中的图片。

提交后立即返回

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "seedance-2.0-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1784113595
}

task_id：任务 ID，用于后续查询进度和下载结果

status：任务状态，见下方任务状态说明

progress：任务进度百分比

任务进度查询与结果获取

复用共用节点：

查询任务状态：视频任务查询（共用） GET /v1/videos/{task_id}

下载视频：视频内容下载（共用） GET /v1/videos/{task_id}/content

任务状态依次为 queued、in_progress、completed、failed。建议每 5-10 秒轮询一次，生成一般需要 4-7 分钟。

任务完成后查询接口返回：

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "seedance-2.0-fast",
  "status": "completed",
  "progress": 100,
  "created_at": 1784113595,
  "completed_at": 1784113821,
  "url": "https://iliu.ai/v1/videos/task_xxx/content",
  "video_url": "https://iliu.ai/v1/videos/task_xxx/content",
  "result_url": "https://iliu.ai/v1/videos/task_xxx/content"
}

url、video_url、result_url 三个字段值相同，即视频下载地址。下载时需携带 Authorization 头，接口返回 302 跳转到视频文件，curl 请加 -L 参数跟随跳转：

任务完成后短时间内下载接口若返回 502，说明成片转存尚未完成，稍后重试即可。

输出视频为 HEVC 编码 MP4，包含音轨。

任务失败

任务失败时查询接口返回：

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "seedance-2.0-fast",
  "status": "failed",
  "progress": 100,
  "error": {
    "message": "upstream returned unrecognized message",
    "code": "task_failed"
  }
}

常见失败原因：文生视频任务携带了 metadata 字段。

错误码

HTTP 状态码	触发条件	返回示例
400	缺少 prompt	`{"code": "invalid_request", "message": "prompt is required", "data": null}`
401	令牌无效或缺失	`{"error": {"message": "Invalid token", "type": "new_api_error"}}`

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Seedance 2.0 Fast 视频生成