图生视频请求被拒：图片 URL 无效、尺寸和格式错误怎么解决

图生视频请求被拒通常源于三类问题：参考图片 URL 无法访问、图片数量或格式不符合规范、以及提示词中的引用标记与实际媒体不匹配。解决方法是将参考媒体放入 metadata.content[],在 prompt 中以 @image1 到 @imageN 正确引用,并确认单次请求不超过 9 张参考图片、3 段参考视频和 3 条音轨的上限。RelayDance 采用 OpenAI 兼容协议,失败请求不计费,可先排查后重试。

如何正确放置参考图片与引用标记

参考图片必须放入 metadata.content[] 数组,并在提示词中以 @image1 到 @imageN 的形式引用。若 URL 指向的资源无法公开访问,或引用标记数量与 content[] 中的媒体项不对应,请求会被拒绝。单次请求支持最多 9 张参考图片、3 段参考视频和 3 条音轨,片段时长上限为 15 秒。提交视频任务使用 POST /v1/video/generations,需携带 model、prompt、seconds 及 metadata 字段。请确认每个 URL 可通过外部网络访问,格式为常见图像类型,并逐一核对 @imageN 序号与数组顺序一致。详见 https://relaydance.com/docs。

接口协议与鉴权配置

请求被拒也可能由 base_url 或鉴权配置错误引起,请优先确认接口地址与 API Key。RelayDance 使用 OpenAI 兼容协议,据 relaydance.com/docs 官方文档:「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。鉴权方式为 Authorization: Bearer YOUR_API_KEY,密钥可在 https://relaydance.com/console 创建。若 base_url 未改为 https://relaydance.com/v1,或 Key 缺失、失效,服务端会返回错误。视频任务提交后,可通过 GET /v1/video/generations/{task_id} 轮询状态,直到 status 变为 succeeded 或 failed,结果中包含视频 url。图像生成则使用 POST /v1/images/generations。

失败请求是否会计费

失败或报错的请求不会产生费用,因此可以放心重试排查。据 relaydance.com 官方文档:「失败或报错的请求一律不计费」。RelayDance 采用按生成量的 pay-as-you-go 计费方式,只对成功生成的视频收费。以 Seedance 2.0 为例,720p 约 $0.190/秒,1080p 约 $0.470/秒,Seedance Fast 约 $0.152/秒,原生 4K 约 $4.90/5 秒条。gpt-image-2 的图像输出免费,只按输入计费,图生图约 ¥0.035 起,4K 与 1K 出图同价。实时的分模型费率请查看 https://relaydance.com/models。因图片 URL 无效或格式错误导致的失败,均不计入账单。

排查步骤与费率对照

按以下步骤逐项排查,可定位图片 URL、尺寸或格式问题。

1. 确认参考图片 URL 可被外部网络公开访问,且为常见图像格式。
2. 检查 metadata.content[] 中的媒体项数量:图片不超过 9 张,视频不超过 3 段,音轨不超过 3 条。
3. 核对 prompt 中的 @image1 到 @imageN 与数组顺序一一对应。
4. 确认 base_url 为 https://relaydance.com/v1,并携带有效 Authorization: Bearer 头。
5. 参考片段时长不超过 15 秒,重试请求(失败不计费)。

常见问题 FAQ

问：一次请求最多能上传多少张参考图片？

答：单次请求最多支持 9 张参考图片、3 段参考视频和 3 条音轨,参考片段时长上限为 15 秒。

问：请求因图片 URL 无效被拒后会扣费吗？

答：不会。据 relaydance.com 官方文档:「失败或报错的请求一律不计费」,可修正后重新提交。

问：如何从现有 OpenAI SDK 迁移到 RelayDance？

答：将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可,鉴权使用 Authorization: Bearer YOUR_API_KEY,密钥在 https://relaydance.com/console 创建。