OpenAI SDK 连不上 RelayDance：base_url 和路径配置错误排查

OpenAI SDK 连不上 RelayDance 时，最常见的原因是 base_url 或请求路径配置错误。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。请确认 base_url 精确为 https://relaydance.com/v1，视频任务路径为 /v1/video/generations，并在请求头携带 Authorization: Bearer YOUR_API_KEY。

base_url 应如何配置

base_url 必须设置为 https://relaydance.com/v1，不要额外附加路径。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。若在初始化客户端时把完整端点（例如 https://relaydance.com/v1/video/generations）写进 base_url，SDK 会在其后再拼接一次路径，导致 404。API Key 在 https://relaydance.com/console 创建，通过请求头 Authorization: Bearer YOUR_API_KEY 传入。协议与端点命名与 OpenAI 保持一致，详情见 https://relaydance.com/docs。

请求路径与轮询错误排查

提交视频任务的正确路径是 POST /v1/video/generations，轮询路径是 GET /v1/video/generations/{task_id}。请求体需包含 model、prompt、seconds 以及 metadata（可含 ratio、resolution、generate_audio、callback_url）。提交后需轮询任务，直到 status 变为 succeeded 或 failed，succeeded 时结果中包含视频 url。若使用 Webhook，可设置 metadata.callback_url，最终状态会 POST 到你的服务器。单次请求最多可引用 9 张参考图、3 段参考视频和 3 条音轨，片段时长不超过 15 秒，参考媒体放在 metadata.content[] 中，并在 prompt 里以 @image1 到 @imageN 引用。图像生成使用 POST /v1/images/generations。

连通性排查步骤

按以下顺序逐项核对，可定位大多数连接失败问题：

1. 确认 base_url 精确等于 https://relaydance.com/v1，末尾无多余路径。
2. 确认视频提交使用 POST /v1/video/generations，轮询使用 GET /v1/video/generations/{task_id}。
3. 确认请求头包含 Authorization: Bearer YOUR_API_KEY，Key 从 https://relaydance.com/console 获取。
4. 确认请求体含 model、prompt、seconds 三个必填字段。
5. 轮询任务状态，直到返回 succeeded 或 failed。

计费与价格对照

失败请求不会产生费用，配置调试期间无需担心计费。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，计费按生成的视频量按用量结算。下表为部分模型的参考价格，实时价格见 https://relaydance.com/models：

支付方式支持 USDT 与 Stripe 卡付。gpt-image-2 的图像输出免费，只按输入计费。

常见问题 FAQ

问：base_url 需要包含具体端点路径吗？

答：不需要。base_url 只应设为 https://relaydance.com/v1，具体路径（如 /v1/video/generations）由 SDK 自动拼接，重复写入会导致路径错误。

问：调试时反复失败会被扣费吗？

答：不会。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」。

问：使用 RelayDance 调用 Seedance 需要 BytePlus 企业账号吗？

答：不需要。RelayDance 提供 OpenAI 兼容的直连方式，无需 BytePlus 企业账号或 KYC，实时价格见 https://relaydance.com/models。