视频生成接口文档

通过 OpenAI 兼容接口调用：支持文生视频、图生视频，以及图片/视频/音频多模态参考。
此文档适合的模型：
1、seedance-2-0-fast fast版本
2、seedance-2-0-mini mini版本
3、seedance-2-0-pro 标准满血版

1. 提交视频生成任务 (POST)

HTTP Method: POST

请求路径: https://tokenra.io/v1/video/generations

鉴权头部: Authorization: Bearer sk-your_token

A. 经典文生视频

B. 单图/首尾帧图生视频

传入 1 张图为首帧；传入 2 张图时，第一张为首帧、第二张为尾帧。

C. 多图外观/主体参考生视频（不含视频参考）

多张外观参考时，使用带 role（或等价 type）的对象数组，取值为 "reference_image"。

D. 图像参考 + 视频参考多模态混合生成

火山 Seedance 支持"图像参考（控制主体外观）+ 视频参考（控制镜头/运动轨迹）"混合生成。若请求中同时包含 videos，所有 images 均会被自动识别为外观参考。

2. 轮询获取任务结果 (GET)

请求路径: /v1/video/generations/{task_id}

3. 完整参数字典说明

OpenAI 兼容参数名	类型	必填	默认值	描述与限制
`model`	string	✅	-	目标视频生成模型名，传入 seedance-2-0-fast、seedance-2-0-mini、seedance-2-0-pro 等
`prompt`	string	✅	-	视频生成画面与动作描述提示词，对中文理解极佳
`images` / `image_urls`	array	❌	-	图片参考数组。智能模式下：1张为首帧，2张为首尾帧。支持使用对象形式指定 `role` 或其等价字段 `type`（如 `"first_frame"`, `"last_frame"`, `"reference_image"`）
`videos`	array	❌	-	视频参考链接数组，用于控制视频生成的运动、背景或场景
`audios`	array	❌	-	音频参考链接数组，实现视频声画融合
`resolution`	string	❌	`"720p"`	目标视频清晰度，可选 `"720p"`、`"1080p"`
`ratio`	string	❌	`"16:9"`	目标画幅比例，可选 `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"`, `"1:1"`
`duration`	integer	❌	`5`	视频时长（秒）
`camera_fixed`	boolean	❌	`false`	是否锁定镜头（保持静态视角拍摄）
`generate_audio`	boolean	❌	`false`	是否同步生成匹配的视频背景环境音效
`web_search`	boolean	❌	`false`	是否启用联网搜索
`seed`	integer	❌	-	随机种子值，用于多次生成时的效果控制

4. 返回结果示例 (200 OK)

提交任务响应：

{
  "id": "video_task_abc123",
  "task_id": "video_task_abc123",
  "status": "pending",
  "message": "Task submitted successfully"
}

查询结果响应（已完成）：

{
  "id": "video_task_abc123",
  "task_id": "video_task_abc123",
  "status": "completed",
  "data": [
    {
      "url": "https://example.com/output/generated_video.mp4"
    }
  ]
}

5. 常见失败返回示例

本平台接口遵循标准的 HTTP 状态码与统一的 JSON 错误响应格式。

状态码	说明
`400 Bad Request`	参数错误 / 模型不存在
`401 Unauthorized`	API Key 无效 / 未授权
`429 Too Many Requests`	余额不足 / 频控限制

400 响应示例：

{
  "error": {
    "message": "The model does not exist or you do not have access to it.",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}

排查建议：

检查请求体中的 model 字段值是否正确，参考"开放端点一览表"中的可用模型

使用 JSON 校验工具检查请求体格式，确保逗号和括号闭合正确

Seedance 2.0 API接口文档（Mini、Fast、Pro版）

视频生成接口文档#

1. 提交视频生成任务 (POST)#

A. 经典文生视频#

B. 单图/首尾帧图生视频#

C. 多图外观/主体参考生视频（不含视频参考）#

D. 图像参考 + 视频参考多模态混合生成#

2. 轮询获取任务结果 (GET)#

3. 完整参数字典说明#

4. 返回结果示例 (200 OK)#

5. 常见失败返回示例#