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

480p 视频超分任务报错，多数由请求参数不完整、参考媒体超出上限，或分辨率与时长设置不匹配引起。RelayDance 采用 OpenAI 兼容接口，通过 POST /v1/video/generations 提交任务并轮询状态，失败请求不产生费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此重试成本可控。定位报错后调整参数即可恢复正常出图。

接口调用与参数配置

超分任务报错的第一步排查是确认接口地址与协议配置正确。RelayDance 使用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。提交视频任务使用 POST /v1/video/generations，需包含 model、prompt、seconds 及 metadata（含 ratio、resolution、generate_audio、callback_url）。鉴权头为 Authorization: Bearer YOUR_API_KEY，密钥可在 https://relaydance.com/console 创建。若 base_url 未修改或密钥缺失，请求会直接报错。详见 https://relaydance.com/docs。

参考媒体超限导致的失败

参考媒体数量或时长超出上限是常见报错来源。参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用。单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，片段时长上限为 15 秒。若上传第 10 张参考图或提交超过 15 秒的片段，任务会失败。排查时逐项核对 content[] 内的媒体计数与单条时长，删除超出部分或拆分为多次请求。调整后重新提交，失败请求不计入费用。

分辨率与计费对照

确认分辨率设置与目标价格档位一致可避免配置错误。480p 超分常涉及升档到 720p 或 1080p，不同档位按秒或按条计费，具体如下表所示（来源 relaydance.com/models）。

实时费率见 https://relaydance.com/models。若 resolution 字段与所选模型不兼容，请对照上表修正。

报错排查步骤

按以下顺序排查可定位多数超分失败原因。

1. 确认 base_url 为 https://relaydance.com/v1，鉴权头包含有效 YOUR_API_KEY。
2. 检查 model、prompt、seconds 三个必填字段是否齐全。
3. 核对 metadata.content[]：参考图不超过 9 张，参考视频不超过 3 段，音轨不超过 3 条，单片段不超过 15 秒。
4. 确认 metadata.resolution 与所选档位（720p 约 $0.190/秒，1080p 约 $0.470/秒）匹配。
5. 轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded 或 failed，读取返回的 video url。

常见问题 FAQ

Q1：任务失败会扣费吗？不会。RelayDance 采用按量计费，失败或报错的请求一律不计费，可放心重试。

Q2：如何异步接收超分结果？设置 metadata.callback_url，任务最终状态会以 POST 方式推送到你的服务器（Webhook 模式）。

Q3：图像出图如何计费？据 relaydance.com/models，gpt-image-2 图像输出免费，只按输入计费；图生图约 ¥0.035 起，4K 与 1K 出图同价。