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

Seedance 提示词里的 @imageN 引用不生效，多数原因是 @image1 到 @imageN 的编号没有与 metadata.content[] 数组的顺序一一对应。在 RelayDance 中，参考图片放在 metadata.content[] 里，提示词按数组顺序用 @image1、@image2 依次引用；单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨。核对编号与数组下标是否一致，通常即可修复引用失效问题。

@imageN 的编号如何与 content 数组对应

@imageN 的编号严格按照 metadata.content[] 数组中媒体的排列顺序确定，@image1 指向数组第一项。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此请求结构与常见 SDK 一致。参考图片写在 metadata.content[] 中，提示词里用 @image1 到 @imageN 引用。若把第二张图误写成 @image1，模型就会引用错误素材。检查数组顺序与提示词编号是否逐一对齐，是排查引用失效的第一步。详见 https://relaydance.com/docs。

content 数组的数量与类型限制

content 数组存在明确的数量上限：单次请求最多 9 张参考图片、3 段参考视频和 3 条音轨，单个片段时长最长 15 秒。当放入的媒体超过这些上限时，多出的素材不会被纳入，对应的 @imageN 引用自然无法命中。请确认参考图片总数不超过 9 张，且视频与音频分别在 3 个以内。同时注意 @imageN 只用于图片编号，视频和音频有各自的引用方式。逐项核对数量、类型与提示词中出现的最大编号，可以避免因超限导致的引用为空。

提交与轮询流程如何验证引用是否生效

提交视频任务后，可通过轮询任务状态确认参考媒体是否被正确处理。提交视频任务：POST /v1/video/generations，携带 model、prompt、seconds 及 metadata（含 content[]）。随后 GET /v1/video/generations/{task_id} 轮询，直到 status 为 succeeded 或 failed，结果中包含视频 url。也可设置 metadata.callback_url 使用 Webhook，将最终状态 POST 到你的服务器。排查引用问题的建议步骤：

1. 确认 metadata.content[] 中图片的排列顺序。
2. 核对提示词里 @image1 到 @imageN 与数组下标一一对应。
3. 检查图片数量不超过 9 张。
4. 提交后通过 GET 轮询查看 status 与返回结果。

不同分辨率与计费的关系

参考媒体的引用逻辑与所选模型分辨率无关，但会影响单次生成的按秒或按条计费。RelayDance 采用按量计费，据 relaydance.com 官方文档「失败或报错的请求一律不计费」，因此调试 @imageN 引用时，若请求报错则不产生费用。下表列出部分公开单价，实时费率见 https://relaydance.com/models：

常见问题 FAQ

问：@image1 一定是数组里的第一张图吗？

是的。@imageN 的编号按 metadata.content[] 数组的顺序确定，@image1 对应第一项，依次类推。

问：一次最多能放多少张参考图片？

单次请求最多 9 张参考图片，另外支持 3 段参考视频和 3 条音轨，单个片段最长 15 秒。

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

不会。据 relaydance.com 官方文档，失败或报错的请求一律不计费。