创建 Seedance 视频

Seedance 2.0 / 2.5 视频生成，使用 OpenAI 视频接口格式。任务异步执行：

1. POST /v1/videos 创建任务，返回任务 ID；
2. 用 查询视频 GET /v1/videos/{task_id} 轮询状态，直到 status 为 completed 或 failed；
3. 完成后用 获取视频内容 GET /v1/videos/{task_id}/content 下载成品，同样需要携带令牌。查询结果里不返回视频地址。

这些模型只支持 /v1/videos，不支持通用的 /v1/video/generations。

模型与分辨率

选择模型不支持的分辨率会直接返回 400，不会扣费。

主要参数

metadata 中未列出的字段不会转发。素材也可以用通用的 metadata.content 写法传入：image_url 的 role 可为 first_frame、last_frame、reference_image（不写则视为首帧），video_url 为参考视频，audio_url 为参考音频；与上表中的显式字段同时出现时以显式字段为准。

参考视频要求

• 格式 mp4 / mov，单个不超过 200 MB；
• 数量与时长：Seedance 2.0 系列最多 3 个，单个 2–15 秒，总时长 ≤15 秒；Seedance 2.5 最多 10 个，单个 2–30 秒，总时长 ≤30 秒；
• 分辨率 480p / 720p / 1080p / 4k，宽高比 0.4–2.5，宽和高各在 300–6000 px 之间，宽 × 高在 407,696–8,295,044 之间；
• 帧率 24–60 fps；
• 必须是上游可以直接拉取的公网地址。海外链接可能拉取超时，建议使用国内对象存储。

计费

• 按输出视频秒数计费，单价随分辨率不同。
• 带参考视频时换用「有参考视频」的单价，计费秒数为 输出秒数 + 参考视频秒数。参考视频的实际时长无法从请求中获取，因此统一按该模型的总时长上限计：Seedance 2.0 系列按 15 秒，Seedance 2.5 按 30 秒。例如 720p、输出 5 秒、带参考视频，按 (5 + 15) 秒 × 720p 有参考视频单价收费。
• seconds 传 -1 时先按 15 秒预扣，任务完成后按实际交付时长结算。
• 任务失败全额退还。各模型的具体单价见模型广场。

示例

curl https://your-platform.com/v1/videos \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0-mini",
    "prompt": "参考视频1的第一人称运镜和节奏，拍一段清晨在茶园小路上漫步的画面",
    "seconds": 5,
    "videos": ["https://arkdocs.tos-cn-beijing.volces.com/videos/video-generation/r2v_tea_video1.mp4"],
    "metadata": { "resolution": "720p", "ratio": "16:9" }
  }'

文生视频去掉 videos 即可；图生视频把 videos 换成 "metadata": { "first_frame_image": "https://..." }。

curl -X POST "https://loading/v1/videos" \  -H "Content-Type: application/json" \  -d '{    "model": "seedance-2-0",    "prompt": "一只橘猫在阳光草地上奔跑，电影质感浅景深",    "seconds": 5,    "metadata": {      "resolution": "720p",      "ratio": "16:9"    }  }'

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1793945221
}

{
  "error": {
    "message": "string",
    "type": "string",
    "code": "string"
  }
}