视频生成 API 返回 500 或 503：什么时候该重试，什么时候该放弃

当 RelayDance 视频生成 API 返回 500 或 503 时，判断依据是错误的性质：500 通常表示服务端临时故障，503 表示服务暂时不可用，两者一般可以在退避后重试；而 400 类参数错误应放弃并修正请求。关键前提是计费规则，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此对 500 或 503 进行受控重试不会产生额外费用。

500 与 503 的含义与重试判断

500 与 503 属于服务端错误，多数情况下可重试，但需要区分场景。500 表示服务端内部异常，503 表示服务暂时不可用（例如负载过高）。这两类错误通常是瞬时的，适合配合指数退避重试。相比之下，4xx 类错误（如 400 参数错误、401 鉴权失败）属于客户端问题，重试无意义，应直接放弃并修正。由于计费按已生成视频的 pay-as-you-go 计算，且失败请求不计费，重试 500 或 503 不会带来重复扣费风险。实时价格可在 https://relaydance.com/models 查看，例如 Seedance 2.0 720p 约 $0.190 / 秒。

推荐的重试策略与退避

建议对 500 与 503 采用有限次数的指数退避重试，避免无限循环。视频生成为异步任务：提交后通过 POST /v1/video/generations 创建，再轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded 或 failed。若提交阶段返回 500 或 503，可重试；若轮询过程中最终 status 为 failed，则应视为业务失败并停止重试。推荐的退避序列如下：

1. 第 1 次重试：等待 2 秒
2. 第 2 次重试：等待 4 秒
3. 第 3 次重试：等待 8 秒
4. 超过 3 次仍失败：记录日志并放弃

由于失败请求不计费，上述重试在费用上是安全的。也可改用 Webhook 模式，设置 metadata.callback_url，由服务端接收最终状态，减少轮询压力。

哪些情况应直接放弃

遇到明确的客户端错误或最终 failed 状态时应直接放弃，而不是继续重试。参数错误（400）、鉴权失败（401）以及任务轮询后返回的 failed 状态均属于此类，重试无法改变结果。此时应检查 model、prompt、seconds 以及 metadata 中的 ratio、resolution 等字段是否正确，或确认 Authorization: Bearer YOUR_API_KEY 是否有效（可在 https://relaydance.com/console 创建密钥）。同样，因为「失败或报错的请求一律不计费」，放弃并修正请求不会造成金钱损失，重点是尽快定位配置问题而非盲目重试。

不同错误类型的处理对照

下表汇总了常见状态码对应的处理方式，便于在客户端逻辑中直接映射。

接口迁移与成本参考

RelayDance 采用 OpenAI 兼容协议，迁移改动很小。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此重试逻辑可直接复用现有的 OpenAI SDK 封装。成本方面可作为容错决策参考：Seedance 2.0 1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。因失败不计费，即便对高价档位（如 4K）触发重试，也仅在成功生成时才计费。详细协议见 https://relaydance.com/docs，实时费率见 https://relaydance.com/models。

常见问题 FAQ

问：重试 500 或 503 会被重复扣费吗？

不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，只有成功生成的视频才按 pay-as-you-go 计费。

问：轮询时任务返回 failed 该怎么办？

应直接放弃该任务。failed 属于最终状态，重试同一 task_id 无意义，需要重新提交并检查 prompt 与 metadata 参数。

问：需要修改代码才能接入重试逻辑吗？

改动很小。将 base_url 改为 https://relaydance.com/v1 并使用 Authorization: Bearer YOUR_API_KEY 即可，重试与退避逻辑可沿用现有 OpenAI SDK 实现。