Seedance API 返回 429 Too Many Requests：限流原因与重试策略

当 Seedance API 返回 429 Too Many Requests 时，表示短时间内的请求量触发了限流，服务器暂时拒绝新请求。正确做法是捕获该状态码，采用指数退避后重试，而不是立即高频重发。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此 429 场景下的重试不会带来额外费用，可放心配置自动重试逻辑。

429 的常见触发原因

429 通常由并发请求过多或短时请求频率过高触发。在提交视频任务 POST /v1/video/generations 或图像任务 POST /v1/images/generations 时，如果客户端在轮询 GET /v1/video/generations/{task_id} 阶段以过短间隔连续请求，也可能累积到限流阈值。单次请求最多可携带 9 张参考图、3 段参考视频与 3 条音频轨，片段时长最长 15 秒；此类大请求本身不会额外触发 429，但密集提交会。实时的按模型费率可在 https://relaydance.com/models 查询，建议在压力测试时同时观察计费与限流表现。

推荐的重试策略

面对 429，应使用指数退避加随机抖动的重试机制。以下是建议步骤：

1. 捕获 HTTP 状态码 429，读取响应头中的重试提示（若有）。
2. 首次等待约 1 秒后重试，之后每次将等待时间加倍（1s、2s、4s、8s）。
3. 在每次等待值上叠加随机抖动，避免多客户端同时重发。
4. 设置最大重试次数（例如 5 次）与总超时上限，超过则记录失败。
5. 对轮询请求单独放宽间隔，例如每 3 至 5 秒查询一次任务状态。

由于 RelayDance 按生成量计费，重试不会因 429 产生费用，可将重试逻辑集成到现有 OpenAI SDK 中。

用 OpenAI 兼容 SDK 配置重试

RelayDance 兼容 OpenAI SDK，无需更换客户端库即可复用其内置重试能力。据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。将 base_url 指向 https://relaydance.com/v1，并通过 Authorization: Bearer YOUR_API_KEY 完成鉴权，API Key 可在 https://relaydance.com/console 创建。多数 OpenAI SDK 提供 max_retries 参数，可直接对 429 与网络错误自动退避重试。接口协议与参数说明见 https://relaydance.com/docs。因失败请求不计费，可将 max_retries 设为较高值而不担心成本。

不同分辨率下的费率与请求规划

规划重试与并发时，可结合各模型费率评估成本预算。下表列出部分实时费率参考：

由于 429 引发的重试不计费，成本仅在任务成功生成时产生。支付方式支持 USDT 与 Stripe 卡，采用按量付费。以上均为参考值，最新数据以 https://relaydance.com/models 为准。

FAQ

问：429 期间的重试会被计费吗？

不会。据 relaydance.com 官方文档，失败或报错的请求一律不计费，因此 429 触发的重试不产生费用。

问：轮询任务状态时也会触发 429 吗？

可能。若以过短间隔连续调用 GET /v1/video/generations/{task_id}，请将轮询间隔放宽至每 3 至 5 秒一次。

问：需要更换 SDK 才能配置重试吗？

不需要。保留 OpenAI SDK，将 base_url 改为 https://relaydance.com/v1，即可使用其 max_retries 参数处理 429。