> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 多参考图

> 用多张参考图控制人物、商品和风格一致性 · 当前为规划能力

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

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

## 适合场景

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

## 规划中的请求结构

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

```json theme={null}
{
  "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`。