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

图生视频请求被拒通常由三类问题引起：参考图片 URL 无法访问、图片尺寸或数量超限、引用格式书写错误。RelayDance 采用 OpenAI 兼容协议，参考媒体统一放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用。单次请求最多支持 9 张参考图片、3 段参考视频与 3 条音轨。若请求失败，据 relaydance.com 官方文档「失败或报错的请求一律不计费」，可放心排查后重试。

如何修复无效的图片 URL

修复无效图片 URL 的关键是确保链接可被服务端公开访问。参考媒体需放入 metadata.content[]，服务端会拉取这些资源，因此本地路径、需要登录的私有链接或临时签名过期的地址都会导致请求被拒。请使用可直接访问的公网 HTTPS 链接，并在 prompt 中用 @image1 到 @imageN 与 content[] 顺序一一对应。接口协议为 OpenAI 兼容，据 relaydance.com 官方文档「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需改动 SDK 结构即可完成图生视频任务提交。

参考图片尺寸和数量限制

参考媒体的数量和时长有明确上限，超限会直接导致请求被拒。单次请求最多支持 9 张参考图片、3 段参考视频和 3 条音轨，且视频片段最长 15 秒。当同时提交图片与视频时，请核对各类媒体总数是否分别在这些上限之内。若引用编号超过实际提供的媒体数量（例如提供 3 张图片却在 prompt 中引用 @image4），也会触发错误。建议在提交前逐项核对 content[] 数组长度与 prompt 中的 @imageN 引用编号是否匹配，详细参数说明见 https://relaydance.com/docs。

请求提交与轮询排查步骤

排查图生视频请求可按以下顺序执行，确认每一步返回值：

1. 校验 Authorization: Bearer YOUR_API_KEY 是否有效，密钥可在 https://relaydance.com/console 创建。
2. 确认 base_url 已改为 https://relaydance.com/v1。
3. 提交任务：POST /v1/video/generations，携带 model、prompt、seconds 及 metadata。
4. 将参考图片放入 metadata.content[]，在 prompt 中以 @image1 至 @imageN 引用。
5. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
6. 状态为 failed 时读取错误信息定位 URL、尺寸或格式问题后重试。

各模型价格对照

不同模型的计费单位不同，排查失败请求前可先确认所选模型的价格。以下为各模型的实时费率参考，完整费率见 https://relaydance.com/models：

由于失败请求不计费，因此在修复 URL 或尺寸问题的多次重试过程中，仅成功生成的视频会产生费用。

常见问题 FAQ

问题一：图生视频请求失败会扣费吗？不会。据 relaydance.com 官方文档「失败或报错的请求一律不计费」，仅按成功生成的视频计费。

问题二：参考图片应该放在哪里？放入 metadata.content[]，并在 prompt 中使用 @image1 到 @imageN 引用，编号需与数组顺序对应。

问题三：一次可以提交多少张参考图片？单次请求最多 9 张参考图片、3 段参考视频和 3 条音轨，视频片段最长 15 秒。