首帧尾帧图片不生效：检查 Seedance 首尾帧参数的正确传法

首尾帧图片不生效，通常是因为参考媒体没有放进 metadata.content[]，或提示词里没有用 @image1 到 @imageN 的方式引用它们。在 RelayDance 上，Seedance 通过 POST /v1/video/generations 提交任务，参考图必须先进入 metadata.content[] 数组，再在 prompt 中以 @image1 形式点名，二者缺一，图片都会被忽略。单次请求最多支持 9 张参考图。

正确传法：content[] 加 @imageN 引用

正确做法是把首帧和尾帧图片放入 metadata.content[]，并在提示词中用 @image1 与 @image2 明确引用。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。单次请求上限为 9 张参考图、3 段参考视频与 3 条音轨，单个片段时长最长 15 秒。若图片只写进 content[] 却未在 prompt 中引用，或引用了不存在的编号，首尾帧都会失效。更多参数与实时费率见 https://relaydance.com/models 与 https://relaydance.com/docs。

排查步骤：定位首尾帧失效原因

按以下顺序逐项检查，可快速定位首尾帧不生效的原因。

1. 确认参考图已放入 metadata.content[]，而非提示词纯文本描述。
2. 检查 prompt 是否用 @image1 到 @imageN 引用，且编号与数组顺序对应。
3. 核对参考图数量不超过 9 张，参考视频不超过 3 段，音轨不超过 3 条。
4. 确认片段时长在 15 秒以内。
5. 用 GET /v1/video/generations/{task_id} 轮询状态，直到返回 succeeded 或 failed。
6. 检查 Authorization: Bearer YOUR_API_KEY 请求头，密钥在 https://relaydance.com/console 创建。

各分辨率价格对照

不同模型与分辨率的计费方式不同，可据此评估调试成本。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，因此排查阶段的报错任务不会产生费用。

完整实时费率见 https://relaydance.com/models。

失败请求与轮询结果

调试首尾帧参数时，失败任务不会计入费用，可以放心多次重试。提交任务后用 GET /v1/video/generations/{task_id} 轮询，直到 status 变为 succeeded 或 failed；成功时结果中包含视频 url。也可以设置 metadata.callback_url，任务最终状态会以 POST 方式推送到你的服务器。计费为按生成的视频后付费，支付方式支持 USDT 与 Stripe 卡。若首尾帧始终不生效但任务显示 succeeded，应重点检查 @imageN 引用与 content[] 顺序是否一致。

FAQ

问：首尾帧图片放在提示词文字里描述可以吗？

不可以。参考图必须放入 metadata.content[]，并在 prompt 中用 @image1 到 @imageN 引用，纯文字描述不会加载图片。

问：一次请求最多能传几张参考图？

单次请求最多 9 张参考图，另可包含最多 3 段参考视频与 3 条音轨，片段时长最长 15 秒。

问：调试时反复报错会扣费吗？

不会。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，只有成功生成的视频才按秒或按条计费。