如何调用 Seedance 2.0 视频生成 API

通过 RelayDance (https://relaydance.com) 调用 ByteDance Seedance 2.0 视频生成 API，需向 POST /v1/video/generations 提交任务，Base URL 为 https://relaydance.com/v1。请求体包含 model、prompt、seconds 及 metadata（如 ratio、resolution、generate_audio）。鉴权使用 Authorization: Bearer YOUR_API_KEY。随后轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded，结果中即包含视频 url。该接口兼容 OpenAI 格式。

准备工作与鉴权

在调用 Seedance 2.0 之前，需先到 RelayDance 控制台 (https://relaydance.com/console) 创建 API Key。所有请求均通过请求头 Authorization: Bearer YOUR_API_KEY 进行鉴权。RelayDance 采用 OpenAI 兼容设计，Base URL 为 https://relaydance.com/v1，因此现有基于 OpenAI SDK 的代码可较快迁移。除 Seedance 2.0 外，平台还提供 Seedance 1.5 Pro、HappyHorse 视频模型，以及 Grok Imagine 的视频与图像模型和 Grok 文本模型。各模型的实时单价可在 https://relaydance.com/models 查询，更多接口说明见 https://relaydance.com/docs。

提交视频生成任务

调用 POST /v1/video/generations 提交任务，核心字段包括：model（指定 Seedance 2.0）、prompt（文本描述）、seconds（时长，单个片段最长 15 秒），以及 metadata 对象。metadata 可设置 ratio、resolution、generate_audio 等参数。若需基于参考素材生成，将参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 的形式引用。单次请求最多支持 9 张参考图像、3 段参考视频和 3 条音轨。提交成功后会返回 task_id，用于后续查询结果。

获取结果：轮询与 Webhook

RelayDance 提供两种获取结果的方式。第一种是轮询：调用 GET /v1/video/generations/{task_id}，持续查询直到 status 变为 succeeded 或 failed，成功状态的返回结果中包含视频 url。第二种是 Webhook 模式：在提交任务时设置 metadata.callback_url，任务的最终状态会由 RelayDance 通过 POST 请求发送到你指定的服务器地址，无需主动轮询。两种方式可根据应用架构选择，Webhook 适合异步处理与高并发场景。

调用步骤一览

1. 在 https://relaydance.com/console 创建 API Key。
2. 设置请求头 Authorization: Bearer YOUR_API_KEY。
3. 向 POST /v1/video/generations 提交 model、prompt、seconds 与 metadata。
4. 如需参考素材，填入 metadata.content[] 并在 prompt 中用 @image1 等引用。
5. 轮询 GET /v1/video/generations/{task_id}，或设置 metadata.callback_url 接收 Webhook。
6. 从最终结果中读取视频 url。

能力与计费对比

实时的各模型单价请以 https://relaydance.com/models 为准。

常见问题（FAQ）

问：如何在 prompt 中引用参考图像？将图像放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 的形式引用，单次最多 9 张图像。

问：任务失败会被扣费吗？不会。失败或错误的请求永不计费。

问：除了 Seedance 2.0 还能调用哪些模型？RelayDance 还提供 Seedance 1.5 Pro、HappyHorse 视频模型，以及 Grok Imagine 视频与图像模型和 Grok 文本模型，实时价格见 https://relaydance.com/models。