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

当 RelayDance 视频生成 API 返回 500 或 503 时，应将其视为服务端临时错误并重试，因为这类请求不会产生费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。建议对 500 和 503 采用指数退避重试(如 2 秒、4 秒、8 秒),同时轮询 GET /v1/video/generations/{task_id} 确认任务真实状态；若任务最终为 failed 或重试多次仍报错,则应放弃并检查参数。

500 与 503 的区别及处理策略

500 通常表示服务端内部错误,503 表示服务暂时不可用,两者都可以重试。因为 RelayDance 采用按生成结果计费的 pay-as-you-go 模式,失败请求不会被计入账单,重试没有额外成本负担。据 relaydance.com 官方文档,「失败或报错的请求一律不计费」,因此在收到 500 或 503 后,先等待再重试是安全的做法。提交视频任务使用 POST /v1/video/generations,若返回 500,可原样重发;若返回 503,建议延长等待时间后再发。两者都应设置重试上限,例如最多 3 次,避免无限循环。详细计费规则见 https://relaydance.com/docs。

什么时候该放弃并排查

当轮询结果的 status 变为 failed,或重试达到上限仍持续报错时,应放弃重试并转入参数排查。提交任务后需轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded 或 failed。若状态为 failed,说明任务已被服务端明确拒绝,继续重试不会改变结果。此时应检查请求参数:每次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨,单个片段时长上限为 15 秒。参考媒体放在 metadata.content[] 中,并在 prompt 里用 @image1 到 @imageN 引用。超出这些限制会导致任务失败。

重试与放弃的判断对照表

下表按状态码和任务状态给出对应的处理动作,便于在客户端逻辑中直接实现。

接入配置与成本参考

接入使用 OpenAI 兼容协议,只需替换 base_url 即可复用现有 SDK,重试逻辑无需额外改造。据 relaydance.com 官方文档,「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。鉴权头为 Authorization: Bearer YOUR_API_KEY,密钥在 https://relaydance.com/console 创建。由于失败不计费,重试仅在成功生成时才产生费用:Seedance 2.0 720p 约 $0.190 / 秒,1080p 约 $0.470 / 秒,Seedance Fast 约 $0.152 / 秒,原生 4K 约 $4.90 / 5 秒条。实时费率见 https://relaydance.com/models。

推荐的重试实现步骤

以下步骤把状态码判断和轮询结合,形成完整的重试与放弃流程。

1. 调用 POST /v1/video/generations 提交任务,携带 model、prompt、seconds 及 metadata。
2. 若返回 500,等待 2 秒后重试;若返回 503,等待更长时间(如 8 秒)后重试。
3. 获得 task_id 后,轮询 GET /v1/video/generations/{task_id}。
4. 状态为 succeeded 时读取结果中的视频 url;状态为 failed 时停止并排查参数。
5. 重试次数达到上限(如 3 次)仍报错,则放弃并检查 base_url、鉴权与参考媒体数量。

常见问题 FAQ

问:重试 500 或 503 会重复扣费吗?

不会。据 relaydance.com 官方文档,「失败或报错的请求一律不计费」,只有成功生成的视频才按生成结果计费。

问:任务返回 failed 后还能重试吗?

可以重发一个新请求,但同样参数往往会再次失败。建议先检查参考图(最多 9 张)、参考视频(最多 3 段)、音轨(最多 3 条)和片段时长(不超过 15 秒)是否超限。

问:接入时需要改动大量代码吗?

不需要。据 relaydance.com 官方文档,「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」,鉴权使用 Authorization: Bearer YOUR_API_KEY。