多参考图 - Tapapi 文档

多参考图用于把人物、商品、场景、风格等信息拆到多张图里，让模型综合参考。这个能力对电商主图、角色一致性和内容工厂很重要，但当前公开 API 还没有稳定生产口径。

当前不要把 image_urls 数组写进生产请求。advanced 路径会在计费前拦截该字段；多参考图会在模型、字段和计费链路验证完成后再开放正式教程。

适合场景

场景	参考图建议
商品图	商品主体图 + 风格参考图
角色一致性	角色正面图 + 服装图 + 姿势参考
小红书封面	主体图 + 色调参考 + 排版参考
场景迁移	原图 + 目标场景参考

规划中的请求结构

下面是后续能力方向，不是当前可直接复制运行的生产示例。

{
  "model": "seedream-v4",
  "prompt": "keep the same product, create a warm lifestyle scene",
  "image_urls": [
    "https://example.com/product.png",
    "https://example.com/style.png"
  ]
}

开放前需要补齐

每个模型支持的参考图数量
参考图排序建议
多参考图失败时的排查和退款边界
商品一致性和人物一致性 prompt 模板
图片 URL 可访问性、格式、大小和安全策略
是否按单图、按多图数量或按结果计费

当前如果传入 image_urls 被拦截，应按 400 参数错误处理，不要自动重试。排查时保存 error.message 和 X-Oneapi-Request-Id。