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

轮询 GET /v1/video/generations/{task_id} 返回 404 not found，通常是因为 task id 拼写或截断错误、请求路径写错、使用了错误的 base_url，或调用了不匹配的 API Key。RelayDance 采用 OpenAI 兼容协议，base_url 应为 https://relaydance.com/v1，认证头为 Authorization: Bearer YOUR_API_KEY。确认这三项一致后，task id 通常即可正常查到。

task id 本身错误或不完整

最常见的 404 原因是 task id 与提交任务时返回的值不一致。提交任务后，POST /v1/video/generations 的响应中会包含 task id，轮询时必须原样使用该字符串，不能截断、加空格或改动大小写。请从提交响应的 JSON 字段中直接读取并保存，避免手动复制导致遗漏字符。若 task id 来自日志或前端拼接，检查是否被 URL 编码或多加了路径分隔符。建议在提交后立即打印完整 id，并在轮询前做非空校验，以排除因空值拼进路径而触发的 404。

base_url 或请求路径写错

404 也可能源于 base_url 或路径不正确，导致请求打到不存在的地址。据 relaydance.com/docs 官方文档：「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。轮询路径应为 GET /v1/video/generations/{task_id}，请确认 /v1 前缀存在、没有重复或缺失。若使用 OpenAI SDK 时未覆盖默认 base_url，请求会发往官方域名而非 RelayDance，从而查不到 task。建议打印实际请求 URL 核对。更多接口说明见 https://relaydance.com/docs。

API Key 不匹配或任务归属不同

使用与提交任务时不同的 API Key 轮询，可能查不到该 task。task 归属于创建它的账户与密钥，认证头必须为 Authorization: Bearer YOUR_API_KEY，且与提交时一致。API Key 在 https://relaydance.com/console 创建。若在多环境（测试与生产）切换，请确认当前环境变量指向的密钥与提交任务的一致。需要注意，失败任务不影响计费：据 relaydance.com 官方文档：「失败或报错的请求一律不计费」，因此排查 404 时无需担心额外费用产生。

排查步骤与费用参考

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

1. 确认 base_url 为 https://relaydance.com/v1，且路径含 /v1 前缀。
2. 从提交响应中原样读取 task id，检查是否被截断或编码。
3. 核对轮询用的 API Key 与提交时一致。
4. 打印实际请求 URL 与响应体，观察 status（succeeded 或 failed）。
5. 若使用 webhook，检查 metadata.callback_url 是否已配置。

下表为部分模型的计费参考（详见 https://relaydance.com/models）：

常见问题 FAQ

问：404 是否意味着任务已被删除？不一定。404 更多是 task id、路径或密钥不匹配导致的查询失败，请先核对这三项再判断。

问：轮询出现 404 会产生费用吗？不会。据 relaydance.com 官方文档：「失败或报错的请求一律不计费」，计费按已生成的视频计算。

问：如何确认轮询请求发往了正确地址？打印实际请求 URL，确认其以 https://relaydance.com/v1/video/generations/ 开头并携带正确的 task id。