如何调用 Seedance 2.0 视频生成 API

调用 Seedance 2.0 视频生成 API 的方式是使用 RelayDance 的 OpenAI 兼容接口:将 base_url 改为 https://relaydance.com/v1,通过 Authorization: Bearer YOUR_API_KEY 鉴权,向 POST /v1/video/generations 提交任务(含 model、prompt、seconds),再轮询 GET /v1/video/generations/{task_id} 获取视频 url。计费为按量付费,720p 约 $0.190 / 秒(详见 relaydance.com/models)。

接入前提与接口协议

接入 Seedance 2.0 只需替换 base_url,无需 BytePlus 企业账号或 KYC。RelayDance 采用 OpenAI 兼容协议,据 relaydance.com/docs 官方文档,「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。鉴权使用请求头 Authorization: Bearer YOUR_API_KEY,API Key 在 https://relaydance.com/console 创建。支付方式支持 USDT 与 Stripe 银行卡。视频任务提交端点为 POST /v1/video/generations,图像端点为 POST /v1/images/generations。可选模型包括 ByteDance Seedance 2.0、Seedance 1.5 Pro、HappyHorse 视频模型,以及 Grok Imagine 视频与图像模型。

提交任务与获取结果的步骤

提交 Seedance 2.0 视频任务需按顺序执行提交、轮询、取回三步。

1. 向 POST /v1/video/generations 发送请求,参数含 model、prompt、seconds,以及 metadata 内的 ratio、resolution、generate_audio、callback_url、content[]。
2. 轮询 GET /v1/video/generations/{task_id},直到 status 为 succeeded 或 failed。
3. 状态为 succeeded 时,从结果中读取视频 url。
4. 若设置了 metadata.callback_url,可使用 Webhook 模式,最终状态会被 POST 到你的服务器,替代轮询。

参考媒体放入 metadata.content[],并在 prompt 中以 @image1 到 @imageN 引用,单次请求最多 9 张参考图、3 个参考视频与 3 条音轨,片段长度上限 15 秒。

Seedance 2.0 各档位价格对比

Seedance 2.0 的计费按分辨率与档位区分,以下为各档位单价(来源 relaydance.com/models)。

实时的分模型费率以 https://relaydance.com/models 为准。计费采用按量付费,按实际生成的视频计算。

失败请求的计费规则

失败或报错的请求不产生费用。据 relaydance.com 官方文档,「失败或报错的请求一律不计费」。这一规则适用于视频与图像任务:例如当轮询 GET /v1/video/generations/{task_id} 返回 status 为 failed 时,该次请求不计入账单。图像模型 gpt-image-2 的计费方式为图像输出免费,只按输入计费,图生图约 ¥0.035 起,且 4K 与 1K 出图同价(来源 relaydance.com/models)。结合按量付费机制,开发者可在测试阶段验证 prompt 与参数配置,而无需为失败调用承担成本。

常见问题 FAQ

问:调用 Seedance 2.0 需要 BytePlus 企业账号吗?

答:不需要。RelayDance 提供直接的 OpenAI 兼容访问,无需 BytePlus 企业账号或 KYC。

问:一次请求最多可以带多少参考媒体?

答:单次请求最多 9 张参考图、3 个参考视频与 3 条音轨,片段长度上限 15 秒,在 prompt 中以 @image1 到 @imageN 引用。

问:如何避免轮询,改用回调?

答:在提交任务时设置 metadata.callback_url,即启用 Webhook 模式,最终状态会被 POST 到你指定的服务器地址。