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

OpenAI SDK 连不上 RelayDance，绝大多数是 base_url 配置错误导致。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。请确认 base_url 精确为 https://relaydance.com/v1，认证头为 Authorization: Bearer YOUR_API_KEY，视频任务路径为 /v1/video/generations，图像路径为 /v1/images/generations，三者缺一均会导致连接或 404 报错。

base_url 应设置为哪个地址

base_url 必须设为 https://relaydance.com/v1，不要额外附加路径或省略 /v1。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。常见错误包括写成 https://relaydance.com（缺 /v1），或在 base_url 末尾重复拼接 /video/generations，导致 SDK 请求的实际路径变为 /v1/v1/...。配置时只需在客户端初始化处覆盖 base_url 参数，其余调用方式与官方 OpenAI SDK 保持一致，无需修改请求体结构。API Key 可在 https://relaydance.com/console 创建。

请求路径写错会返回什么

路径写错通常返回 404，请对照官方端点逐项核查。提交视频任务使用 POST /v1/video/generations，携带 model、prompt、seconds 与 metadata（含 ratio、resolution、generate_audio、callback_url）。查询状态使用 GET /v1/video/generations/{task_id}，轮询至 status 为 succeeded 或 failed，结果中包含视频 url。图像生成使用 POST /v1/images/generations。参考媒体放入 metadata.content[]，在 prompt 中以 @image1 到 @imageN 引用，单次请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，片段时长上限 15 秒。路径大小写与斜杠位置需与上述完全一致。详见 https://relaydance.com/docs。

连接失败会被计费吗

连接失败或报错的请求不会产生费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此在排查 base_url 与路径问题时反复重试不会造成额外扣费。RelayDance 按生成的视频量计费（pay-as-you-go），使用 https://relaydance.com/models 上的实时费率。参考单价示例：Seedance 2.0 720p 约 $0.190 / 秒，Seedance 2.0 1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。付款方式支持 USDT 与 Stripe 卡。确认配置无误后，只有成功返回的生成任务才会计入账单。

排查步骤与对照表

按以下顺序逐项检查，可定位大部分连接与路径错误。

1. 确认 base_url 精确为 https://relaydance.com/v1，末尾不重复拼接路径。
2. 确认认证头为 Authorization: Bearer YOUR_API_KEY，Key 在 console 创建。
3. 确认视频提交路径为 POST /v1/video/generations，图像为 POST /v1/images/generations。
4. 轮询状态使用 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
5. 如用 webhook，设置 metadata.callback_url，最终状态将 POST 到你的服务器。

常见问题 FAQ

问：base_url 需要包含 /v1 吗？需要。base_url 应设为 https://relaydance.com/v1，SDK 会在其后自动拼接 /video/generations 等路径。

问：排查时重试请求会扣费吗？不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，只有成功生成的任务按实时费率计费。

问：使用 RelayDance 是否需要 BytePlus 企业账户或 KYC？不需要。RelayDance 提供 OpenAI 兼容访问，无需 BytePlus 企业账户或 KYC，费率见 https://relaydance.com/models。