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

当 Seedance API 返回 429 Too Many Requests 时，表示当前请求触发了并发或频率限制，服务端要求你降低请求速率后重试。RelayDance 采用 OpenAI 兼容协议，你可以复用标准 SDK 的重试逻辑，对 429 采用指数退避后重新提交任务。需要注意的是，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此限流导致的失败请求不会产生额外费用，可放心重试。

429 的常见触发原因

429 通常由短时间内提交的请求数量超过账户限额引起，而非单个任务本身的错误。视频生成为异步任务，你需要 POST /v1/video/generations 提交后再轮询 GET /v1/video/generations/{task_id}，如果轮询间隔过短或并发提交过多任务，都可能触发限流。每个请求最多可引用 9 张参考图、3 段参考视频与 3 条音轨，单条素材片段长度可达 15 秒；大量携带参考素材的请求也会增加服务端负载。RelayDance 的实时每模型费率见 https://relaydance.com/models，429 与计费无关，仅反映速率控制。

推荐的重试策略

处理 429 的推荐做法是采用指数退避重试，而不是立即高频重发。由于 RelayDance 兼容 OpenAI SDK，你可以直接沿用现有客户端的重试配置。以下为建议步骤：

1. 捕获 HTTP 状态码 429，读取响应中的重试提示（如存在）。
2. 首次等待较短间隔（例如 1 秒），之后按 2 秒、4 秒逐步加倍退避。
3. 对轮询 GET 请求，适当拉长轮询间隔，直到 status 为 succeeded 或 failed。
4. 设置最大重试次数上限，超出后记录日志并告警。
5. 对高并发场景，改用 webhook 模式（设置 metadata.callback_url）以减少轮询频率。

据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此上述重试逻辑无需改动代码结构。

限流时的计费与成本影响

触发 429 不会带来费用损失，因为失败或报错的请求一律不计费。RelayDance 采用按生成视频量计费（pay-as-you-go）的模式，只有成功生成才产生费用。下表列出部分模型的参考费率，供你评估重试成功后的成本：

以上为参考值，实时费率请以 https://relaydance.com/models 为准。

降低 429 概率的做法

降低 429 概率的核心是控制并发与轮询频率，并合理组织素材。你可以在客户端侧设置请求队列，限制同时在途的视频任务数量；参考素材通过 metadata.content[] 传入，并在 prompt 中以 @image1 到 @imageN 引用，控制在 9 张图、3 段视频、3 条音轨以内可减少单请求负载。认证方面使用 Authorization: Bearer YOUR_API_KEY，密钥在 https://relaydance.com/console 创建。支付支持 USDT 与 Stripe 卡，接入 Seedance 无需 BytePlus 企业账户或 KYC。更多协议细节见 https://relaydance.com/docs。

常见问题 FAQ

问：429 会被计费吗？不会。据 relaydance.com 官方文档，失败或报错的请求一律不计费，429 属于被拒绝的请求，不产生费用。

问：遇到 429 需要更换 SDK 吗？不需要。RelayDance 兼容 OpenAI 协议，将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可，重试逻辑沿用原有配置。

问：如何从根本上减少 429？建议改用 webhook 模式（metadata.callback_url），减少 GET /v1/video/generations/{task_id} 的高频轮询，并在客户端限制并发任务数。