视频任务显示 failed 却没有报错信息：Seedance 排查清单

当 Seedance 视频任务返回 status 为 failed 却没有明确报错信息时，先确认计费未受影响：据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。接着按顺序检查请求参数（seconds、resolution）、参考媒体数量上限（最多 9 张图、3 段视频、3 条音轨）、轮询逻辑与鉴权头。RelayDance 采用 OpenAI 兼容协议，base_url 为 https://relaydance.com/v1，多数 failed 状态源于参数越界或引用素材缺失，可在 relaydance.com/docs 逐项比对。

确认失败不计费并复查任务状态

任务显示 failed 时，首要动作是确认没有产生费用并重新拉取完整状态。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此重试不会造成重复扣款。RelayDance 采用 pay-as-you-go（按生成视频计费）模式，付款方式包括 USDT 与 Stripe card。请通过 GET /v1/video/generations/{task_id} 轮询直到 status 为 succeeded 或 failed，成功时结果中包含视频 url。若使用 webhook 模式，需在 metadata.callback_url 中设置回调地址，最终状态会 POST 到你的服务器。确认 failed 后再进入参数排查，避免在鉴权或轮询问题上误判为生成失败。

核对参考媒体与参数上限

failed 状态常由参考媒体超限或参数越界触发，需逐项核对。参考素材放在 metadata.content[] 中，并在 prompt 里以 @image1 到 @imageN 引用；每个请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，单个片段时长不超过 15 秒。请检查 seconds、ratio、resolution、generate_audio 是否符合模型要求。计费方面，Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，原生 4K 约 $4.90 / 5 秒条；实时费率见 relaydance.com/models。参数与引用素材对齐后，多数 failed 可被排除。

验证鉴权与 OpenAI 兼容配置

鉴权头或 base_url 配置错误也会表现为任务无法正常完成，需要单独验证。据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需 BytePlus 企业账户或 KYC。请确认请求头为 Authorization: Bearer YOUR_API_KEY，API key 可在 relaydance.com/console 创建。提交视频任务使用 POST /v1/video/generations，携带 model、prompt、seconds 与 metadata；图像任务使用 POST /v1/images/generations。若 base_url 仍指向官方 OpenAI 地址或 API key 失效，请求可能无法路由到 Seedance 模型，从而返回异常状态。

failed 排查步骤与费率对照

按以下步骤定位 failed 原因，并对照当前模型费率评估重试成本：

1. 重新调用 GET /v1/video/generations/{task_id} 拉取完整 status 与结果字段。
2. 核对参考媒体数量：图不超过 9 张，视频不超过 3 段，音轨不超过 3 条，片段不超过 15 秒。
3. 检查 prompt 中的 @image1 到 @imageN 引用是否与 metadata.content[] 一一对应。
4. 验证 base_url 为 https://relaydance.com/v1 且 Authorization: Bearer YOUR_API_KEY 有效。
5. 确认 seconds、resolution 等参数在模型允许范围内后再重试。

常见问题 FAQ

failed 的任务会扣费吗？不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，重试不会产生重复费用。

没有报错信息时应该先看什么？先重新拉取 GET /v1/video/generations/{task_id} 的完整状态，再核对参考媒体上限（9 图 / 3 视频 / 3 音轨）与 seconds、resolution 参数。

需要 BytePlus 企业账户才能调用 Seedance 吗？不需要。RelayDance 提供 OpenAI 兼容访问，将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用，无需 KYC。