Node.js TypeScript 接入 Seedance API：提交任务并等待结果

在 Node.js TypeScript 中接入 Seedance API，只需将 OpenAI SDK 的 base_url 改为 https://relaydance.com/v1，用 Authorization: Bearer YOUR_API_KEY 鉴权，然后 POST 到 /v1/video/generations 提交任务，再轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded 或 failed。接口为 OpenAI 兼容，Seedance 2.0 720p 约 $0.190 / 秒，失败请求不计费。详见 relaydance.com/docs。

如何配置 base_url 与鉴权

配置只需替换 base_url 并保留现有 OpenAI SDK。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。在 TypeScript 中，你可以初始化客户端时传入 baseURL: "https://relaydance.com/v1" 和 apiKey: process.env.API_KEY。API Key 在 https://relaydance.com/console 创建，请求头统一使用 Authorization: Bearer YOUR_API_KEY。接口协议与 OpenAI 一致，因此现有基于 OpenAI SDK 的项目无需重写调用逻辑，也无需 BytePlus 企业账号或 KYC 认证。

如何提交视频任务并轮询结果

提交任务用 POST，等待结果用轮询或 webhook 两种方式。向 POST /v1/video/generations 发送 model、prompt、seconds 和 metadata（含 ratio、resolution、generate_audio、callback_url、content[]）。请求返回 task_id 后，用 GET /v1/video/generations/{task_id} 轮询，直到 status 为 succeeded 或 failed，结果中包含视频 url。若在 metadata.callback_url 设置回调地址，最终状态会以 POST 推送到你的服务器。参考媒体放在 metadata.content[] 中，并在 prompt 里以 @image1 到 @imageN 引用，单次请求最多 9 张参考图、3 段参考视频和 3 条音轨，片段时长最长 15 秒。

提交任务的步骤

完整流程分为四步，可直接在 Node.js TypeScript 中实现。

1. 在 https://relaydance.com/console 创建 API Key，并设置请求头 Authorization: Bearer YOUR_API_KEY。
2. 将 base_url 设为 https://relaydance.com/v1，POST 到 /v1/video/generations，传入 model、prompt、seconds 和 metadata。
3. 获取返回的 task_id，用 GET /v1/video/generations/{task_id} 轮询，或在 metadata.callback_url 配置 webhook 接收最终状态。
4. 当 status 为 succeeded 时，从结果中读取视频 url；若为 failed，该次请求不计费。

各模型价格对照

不同分辨率与模型按秒或按条计费，均为用多少付多少。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，因此轮询到 failed 时不会产生费用。以下为 relaydance.com/models 上的对照，实时费率以该页面为准。

常见问题 FAQ

问：提交失败会扣费吗？

不会。计费为 pay-as-you-go，失败或报错的请求一律不计费，轮询返回 failed 时不产生费用。

问：需要 BytePlus 企业账号或 KYC 吗？

不需要。RelayDance 提供 OpenAI 兼容的 Seedance 直接访问，无需 BytePlus 企业账号或 KYC 认证，付款支持 USDT 和 Stripe 卡。

问：单次请求能带多少参考媒体？

参考媒体放在 metadata.content[] 中，单次最多 9 张参考图、3 段参考视频和 3 条音轨，片段时长最长 15 秒，在 prompt 中以 @image1 到 @imageN 引用。