480p 视频超分任务报错：seedance-upscale 常见失败原因与解决

480p 视频超分任务报错时，先确认三点：请求是否符合 OpenAI 兼容协议、参考媒体是否超过上限、轮询状态是否正确处理。RelayDance 采用按生成计费，据 relaydance.com 官方文档「失败或报错的请求一律不计费」，因此报错请求不会产生费用。将 base_url 指向 https://relaydance.com/v1，检查 metadata.content[] 与分辨率参数，即可定位多数失败原因。

接口协议配置错误如何排查

协议配置错误多因 base_url 未正确指向 RelayDance 端点。据 relaydance.com/docs 官方文档「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，保留原有 OpenAI SDK，仅替换 base_url 即可。提交视频任务请使用 POST /v1/video/generations，携带 model、prompt、seconds 与 metadata 字段。认证需在请求头加入 Authorization: Bearer YOUR_API_KEY，密钥可在 https://relaydance.com/console 创建。若报鉴权错误，请确认密钥有效且未遗漏 Bearer 前缀。更多协议细节见 https://relaydance.com/docs。

参考媒体超限导致报错怎么办

参考媒体超过数量或时长上限会直接导致任务失败。参考素材放在 metadata.content[] 中，并在 prompt 里以 @image1 到 @imageN 引用。每个请求最多支持 9 张参考图、3 段参考视频、3 条音轨，单个片段时长不超过 15 秒。当超分任务报错时，请先核对上述数量是否越界，以及每段素材是否超过 15 秒。若引用编号与 content[] 顺序不匹配，同样会触发失败。逐项对照后重新提交，通常可解决因参考媒体引起的报错。

轮询与回调状态处理不当的表现

状态处理不当常被误认为超分任务失败。提交任务后需通过 GET /v1/video/generations/{task_id} 轮询，直到 status 为 succeeded 或 failed，结果中包含视频 url。也可在 metadata.callback_url 设置 Webhook，最终状态会 POST 到你的服务器。若未等待终态就读取结果，会得到空 url，看似报错实为流程未完成。建议在 failed 状态时读取错误信息定位原因。据 relaydance.com 官方文档「失败或报错的请求一律不计费」，即使多次轮询到 failed，也不会产生额外费用。

不同分辨率的计费参考

不同分辨率对应不同单价，排查报错时可据此确认是否选错模型档位。以下为实时费率参考，最新价格见 https://relaydance.com/models。

此外，gpt-image-2 图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。

报错处理步骤

1. 确认 base_url 已改为 https://relaydance.com/v1，且请求头包含 Authorization: Bearer YOUR_API_KEY。
2. 检查 metadata.content[]：参考图不超过 9 张，视频不超过 3 段，音轨不超过 3 条，单片段不超过 15 秒。
3. 核对 prompt 中 @image1 到 @imageN 的引用与 content[] 顺序一致。
4. 通过 GET /v1/video/generations/{task_id} 轮询至 succeeded 或 failed，读取错误信息。
5. 确认所选分辨率档位与预期一致（720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒）。

常见问题

问：超分任务失败会扣费吗？不会。按生成计费为主，失败或报错的请求一律不计费。

问：需要 BytePlus 企业账号或 KYC 吗？不需要。RelayDance 提供 OpenAI 兼容方式直接访问 Seedance，无需 BytePlus 企业账号或 KYC。

问：支持哪些付款方式？支持 USDT 与 Stripe 银行卡，采用按量付费（pay-as-you-go）。