轮询视频任务返回 404 not found：task id 查不到的常见原因

轮询 GET /v1/video/generations/{task_id} 返回 404 not found，通常有三类原因：task id 拼写或截断错误、base_url 未指向 https://relaydance.com/v1、任务提交阶段其实已失败而未生成有效 task id。RelayDance 采用 OpenAI 兼容协议，轮询前请确认提交接口返回了 succeeded 或 pending 状态并附带有效 task id，再用该 id 拼接查询路径。

base_url 配置错误是首要排查项

404 最常见的原因是 base_url 未正确指向 RelayDance 的 OpenAI 兼容端点。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。若 base_url 仍指向 OpenAI 官方或路径缺少 /v1，轮询请求会命中不存在的路由从而返回 404。请检查客户端配置，确保查询路径完整为 https://relaydance.com/v1/video/generations/{task_id}，并在 Header 中携带 Authorization: Bearer YOUR_API_KEY。API Key 可在 https://relaydance.com/console 创建。配置修正后再次轮询，多数 404 问题可解决。参考文档见 https://relaydance.com/docs。

task id 无效或提交阶段已失败

另一类 404 源于 task id 本身无效，多因提交任务时请求已失败但被误当作成功。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，这也意味着失败请求不会返回可轮询的有效 task id。请确认 POST /v1/video/generations 的响应体中确实包含 task id，且未在传输中被截断或多加空格。此外注意参数约束：单次请求最多 9 张参考图、3 段参考视频与 3 条音轨，片段时长不超过 15 秒，参考媒体在 prompt 中以 @image1 到 @imageN 引用。参数越界可能导致提交失败，从而后续轮询查不到 task id。

排查步骤与常见原因对照

按以下顺序逐项排查可快速定位 404 来源。

1. 确认 base_url 为 https://relaydance.com/v1，路径含 /v1。
2. 检查提交接口 POST /v1/video/generations 的响应是否返回有效 task id。
3. 核对轮询 URL 中 task id 是否完整、无空格或换行。
4. 确认 Authorization: Bearer YOUR_API_KEY 已正确携带。
5. 若使用 Webhook 模式，检查 metadata.callback_url 是否已配置以接收最终状态。

计费与费率不受 404 影响

轮询返回 404 不会产生费用，因为 RelayDance 按生成的视频按量计费且失败请求不计费。当前各模型费率以 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 秒条。gpt-image-2 出图时图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。支付方式支持 USDT 与 Stripe 卡。即便轮询短暂返回 404，只要视频未成功生成，就不会计入账单。

常见问题 FAQ

问：轮询一直 404 是否会被扣费？答：不会，据 relaydance.com/docs 官方文档，失败或报错的请求一律不计费，未生成有效视频不计入账单。

问：如何确认 task id 是否有效？答：查看 POST /v1/video/generations 的响应体，有效响应会返回可用于轮询的 task id。

问：Webhook 模式还需要轮询吗？答：设置 metadata.callback_url 后，最终状态会 POST 到你的服务器，可减少对轮询接口的依赖。