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

如果 Seedance 的首帧尾帧图片不生效，通常是因为参考图未放入 metadata.content[]，或提示词中没有用 @image1 到 @imageN 引用。RelayDance 采用 OpenAI 兼容协议，提交视频任务时须通过 POST /v1/video/generations 携带 model、prompt、seconds，并把首尾帧图放进 metadata.content[]，单次请求最多支持 9 张参考图。参数位置正确后图片即可生效。

首尾帧图片的正确传法

首尾帧图片必须放在 metadata.content[] 中，并在 prompt 里以 @image1 到 @imageN 的形式引用。RelayDance 单次请求最多接受 9 张参考图、3 段参考视频与 3 条音轨，生成片段长度可达 15 秒。若图片直接拼在 prompt 文本里，或未用 @imageN 标记引用，图片将不被识别，从而出现首尾帧不生效的现象。据 relaydance.com/docs 官方文档，接口沿用 OpenAI 兼容协议：「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此参数结构与官方 SDK 一致，重点是把参考媒体放对字段。详见 https://relaydance.com/docs。

提交与轮询任务的步骤

提交任务后需通过轮询或 Webhook 获取最终结果，首尾帧图才会体现在返回的视频中。完整流程如下：

1. 调用 POST /v1/video/generations，携带 model、prompt、seconds 与 metadata（含 ratio、resolution、generate_audio、content[]）。
2. 在 metadata.content[] 中放入首尾帧参考图，并在 prompt 用 @image1 等引用。
3. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
4. 成功后从结果中读取视频 url；或设置 metadata.callback_url 由服务端接收最终状态。

Seedance 价格与失败计费说明

Seedance 按生成时长或条目计费，失败请求不产生费用，因此调试首尾帧参数时无需担心报错扣费。Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，这意味着参数传错导致的失败任务不会计入账单。实时费率以 https://relaydance.com/models 为准。

鉴权与接入方式

接入 RelayDance 只需替换 base_url 并携带 API Key，无需 BytePlus 企业账户或 KYC。请求头使用 Authorization: Bearer YOUR_API_KEY，密钥在 https://relaydance.com/console 创建。base_url 设为 https://relaydance.com/v1 即可复用 OpenAI SDK。付款方式支持 USDT 与 Stripe 卡支付，采用按量计费。图像生成使用 POST /v1/images/generations。当首尾帧不生效时，可先确认鉴权头正确、base_url 已替换，再检查 content[] 与 @imageN 引用是否匹配。

常见问题

问：首尾帧图片放在 prompt 文本里可以吗？不可以，参考图必须放入 metadata.content[]，并在 prompt 用 @image1 到 @imageN 引用。

问：单次请求最多能传多少张参考图？最多 9 张参考图，另可含 3 段参考视频与 3 条音轨，片段长度可达 15 秒。

问：调试参数导致任务失败会扣费吗？不会，「失败或报错的请求一律不计费」（据 relaydance.com 官方文档）。