基于 RelayDance 搭 FastAPI 后端：把视频生成开放给自己的用户

在 FastAPI 后端接入 RelayDance，只需将 OpenAI SDK 的 base_url 改为 https://relaydance.com/v1，再用 Authorization: Bearer YOUR_API_KEY 鉴权，即可把视频生成能力开放给自己的用户。后端通过 POST /v1/video/generations 提交任务，轮询 GET /v1/video/generations/{task_id} 获取结果。计费为按量付费，失败或报错的请求一律不计费，接口与 OpenAI 兼容，无需 BytePlus 企业账号或 KYC。

如何用 FastAPI 接入 RelayDance

接入方式是保留 OpenAI SDK 并替换 base_url，无需改动其余调用逻辑。据 relaydance.com/docs 官方文档：「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。在 FastAPI 中，你可以在应用启动时初始化客户端，配置 base_url=https://relaydance.com/v1 与请求头 Authorization: Bearer YOUR_API_KEY，API Key 在 https://relaydance.com/console 创建。提交视频任务请调用 POST /v1/video/generations，携带 model、prompt、seconds 及 metadata（含 ratio、resolution、generate_audio）。更多接口说明见 https://relaydance.com/docs。

提交任务与查询结果的流程

视频生成采用提交加轮询的异步流程，也可用 Webhook 回调。具体步骤如下：

1. 调用 POST /v1/video/generations 提交任务，传入 model、prompt、seconds 和 metadata。
2. 如需引用素材，把参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用；单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，片段最长 15 秒。
3. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed，成功后从结果中取视频 url。
4. 若使用 Webhook，设置 metadata.callback_url，最终状态会 POST 到你的服务器。

各模型价格与计费方式

计费为按生成的视频按量付费，不同分辨率与模型价格不同。下表列出常见档位（数据来源 relaydance.com/models）：

关于失败请求，据 relaydance.com 官方文档：「失败或报错的请求一律不计费」，这意味着后端在轮询到 failed 状态时不会产生费用。图像方面，gpt-image-2 的图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。实时费率以 relaydance.com/models 为准。

把生成能力开放给用户时的注意事项

向自己的用户开放视频生成时，建议在 FastAPI 后端做任务隔离与素材校验。参考媒体统一放入 metadata.content[] 并遵守 9 张图、3 段视频、3 条音轨的上限，单个片段不超过 15 秒。图像生成使用 POST /v1/images/generations 端点。付费方式支持 USDT 与 Stripe 银行卡。由于价格以秒计（如 Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒），后端可据 seconds 与 resolution 预估成本，再向下游用户计价。整套接入无需 BytePlus 企业账号或 KYC。

FAQ 常见问题

问：接入 RelayDance 需要改动现有 OpenAI 代码吗？
答：不需要，保留 OpenAI SDK，仅把 base_url 改为 https://relaydance.com/v1，并使用 Authorization: Bearer YOUR_API_KEY 鉴权即可。

问：任务失败会扣费吗？
答：不会，失败或报错的请求一律不计费。

问：单次请求最多能带多少参考素材？
答：最多 9 张参考图、3 段参考视频和 3 条音轨，片段最长 15 秒，在 prompt 中以 @image1 到 @imageN 引用。