Seedance 提示词里 @imageN 引用不生效：图片顺序和 content 数组的坑

如果 Seedance 提示词里的 @imageN 引用不生效，通常是因为 metadata.content[] 数组里的媒体顺序与提示词编号不对应：@image1 对应数组第一个元素，@imageN 依次类推。RelayDance 采用 OpenAI 兼容协议，单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，只要顺序与编号一致，引用即可正确解析。

content 数组顺序决定 @imageN 的映射

要让 @imageN 生效，请确保 metadata.content[] 中参考媒体的排列顺序与提示词编号严格一致。数组的第一个元素对应 @image1，第二个对应 @image2，以此类推，最多可放入 9 张参考图。如果把图片顺序放错，模型就会引用到错误的素材。RelayDance 采用 OpenAI 兼容接口，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此你可以沿用现有 SDK，只需重点检查 content[] 数组的排列即可。详见 https://relaydance.com/docs。

参考媒体的数量上限与类型

确认引用编号未超过参考媒体的数量上限是排查的关键一步。单次请求中，参考图上限为 9 张，参考视频上限为 3 段，音轨上限为 3 条，视频片段时长不超过 15 秒。如果提示词里写了 @image10 但数组里只有 9 张图片，编号就会指向不存在的元素，从而不生效。不同类型的媒体（图像、视频、音频）分别计数，请将它们统一放入 metadata.content[]，并在提示词中按其在数组中的实际位置引用，避免跨类型混淆编号。

提交与轮询流程排查

确认请求正确提交并轮询到结果，可以帮助区分是引用问题还是任务状态问题。标准流程如下：

1. 使用 POST /v1/video/generations 提交任务，携带 model、prompt、seconds 及 metadata（含 content[]、ratio、resolution）。
2. 用 GET /v1/video/generations/{task_id} 轮询，直到 status 为 succeeded 或 failed。
3. 成功后从结果中读取视频 url；也可设置 metadata.callback_url，由服务器接收最终状态的 POST 回调。

据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此在调试引用问题时反复重试不会产生额外费用。鉴权使用 Authorization: Bearer YOUR_API_KEY，密钥可在 https://relaydance.com/console 创建。

各分辨率计费参考

确认所选模型与分辨率的计费方式，有助于评估调试期间的成本。以下为部分实时费率（来源 relaydance.com/models）：

计费为按生成视频量的 pay-as-you-go 模式，支付方式包括 USDT 与 Stripe 卡。图像方面，gpt-image-2 的图像输出免费，只按输入计费，图生图约 ¥0.035 起，且 4K 与 1K 出图同价。实时费率请以 https://relaydance.com/models 为准。

常见问题 FAQ

问：@image1 到底对应哪张图？

答：对应 metadata.content[] 数组中的第一个元素，@imageN 依次对应第 N 个元素，请保持顺序一致。

问：一次最多能引用多少张图片？

答：单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，视频片段时长不超过 15 秒。

问：调试引用时反复重试会被收费吗？

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