Berry Seedance 2.0

POST /v1/video/generations

使用 new-api 视频生成任务接口提交 Seedance 2.0 视频生成任务。

平台任务接口（推荐）

提交任务：POST /v1/video/generations
查询任务：GET /v1/video/generations/{task_id} 或 GET /v1/tasks/generations/{task_id}
查询任务列表：GET /v1/tasks/generations
取消任务：POST /v1/tasks/generations/{task_id}/cancel

火山官方兼容路径（可选）

与火山文档路径一致，鉴权仍使用当前系统 API Key；{task_id} 一律指创建响应中的平台任务 ID（如 task_xxx），不是上游火山任务 ID。

提交任务：POST /api/v3/contents/generations/tasks（请求体需含 model 以便路由到对应渠道）
查询任务：GET /api/v3/contents/generations/tasks/{task_id}
查询任务列表：GET /api/v3/contents/generations/tasks
取消任务：DELETE /api/v3/contents/generations/tasks/{task_id}

提交成功后使用响应中的 task_id 查询结果。客户端只使用当前系统分发的 task_id，不要直接使用上游 Seedance 2.0 任务 ID。

查询任务列表

平台路径：GET /v1/tasks/generations；官方兼容路径：GET /api/v3/contents/generations/tasks。两者行为相同。

所有参数通过 URL Query 传递，均为可选。只返回当前 API Key 所属用户的任务。列表先在本地任务表筛选，不会调用火山官方批量列表接口。

对于当前页中尚未进入终态（SUCCESS / FAILURE / CANCELLED）的任务，系统会像单任务查询一样，按每条任务创建时绑定的渠道向火山拉取最新状态后再返回；已进入终态的任务直接返回本地记录。拉取上游状态时不需要传 platform 参数。

参数	说明
`p`	页码，默认 `1`
`page_size`	每页数量，默认 `10`，最大 `100`
`task_id`	当前系统分发的任务 ID，精确匹配单条，例如 `task_xxx`
`status`	任务状态，精确匹配：`NOT_START`、`SUBMITTED`、`QUEUED`、`IN_PROGRESS`、`SUCCESS`、`FAILURE`、`CANCELLED`
`action`	任务动作，例如 `generate`
`platform`	可选，仅在本地任务表中按平台类型筛选（如 `54`=Doubao Video、`45`=VolcEngine）；不传则返回所有平台任务
`start_timestamp`	按提交时间筛选，Unix 秒级时间戳，表示起始时间
`end_timestamp`	按提交时间筛选，Unix 秒级时间戳，表示结束时间

curl 'https://YOUR_DOMAIN/v1/tasks/generations?p=1&page_size=20&status=IN_PROGRESS' \
  -H 'Authorization: Bearer YOUR_API_KEY'

取消任务

平台路径：POST /v1/tasks/generations/{task_id}/cancel；官方兼容路径：DELETE /api/v3/contents/generations/tasks/{task_id}。

task_id 放在 URL 路径中，无需请求体。必须是创建任务响应中的 id 或 task_id。系统内部会映射为上游任务 ID 并调用 DELETE /api/v3/contents/generations/tasks/{upstream_task_id}。

curl -X POST 'https://YOUR_DOMAIN/v1/tasks/generations/task_abc123/cancel' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl -X DELETE 'https://YOUR_DOMAIN/api/v3/contents/generations/tasks/task_abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY'

支持文生视频、首帧图生视频、首尾帧图生视频、多模态参考生视频
支持参考图、参考视频、参考音频、同步音频、联网搜索工具、返回尾帧图

输入组合说明：

纯文本：文生视频
文本 + 1 张首帧图：首帧图生视频
文本 + 首帧图 + 尾帧图：首尾帧图生视频
文本 + 参考图/参考视频/参考音频：多模态参考生视频
首帧/首尾帧模式与多模态参考模式互斥

请求参数说明

Seedance 2.0 已与火山官方参数对齐，推荐直接在请求体顶层透传，无需再包一层 metadata：

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "微距镜头拍摄一只玻璃蛙停在叶片上",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true
}

多模态场景可直接传顶层 content；若 content 中包含 text 条目，可不传 prompt
网关便捷字段仍可用：image / images / seconds / size 会自动映射为图片输入、时长和分辨率
metadata 仍兼容旧写法；同一字段若顶层与 metadata 同时存在，以 metadata 为准

Request

Responses

任务提交成功

Berry Seedance 2.0

/v1/video/generations

Request​

Responses​

Request

Responses