> ## 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 Key 接入多种生图模型 · 按模型确认字段边界

一个 API Key + 一个 base\_url，可以接入控制台 / 价格页可见的图片模型。基础接入保持一致；切换模型时通常只改 `model` 字段，但具体支持字段以模型详情和控制台为准。

<Note>下方是精选图片模型说明，不是完整实时列表。更多模型、价格、账号分组和可调用状态以控制台和价格页为准。</Note>

<Note>🔜 即将上线 = 渠道接入中，陆续开放；✅ 可用 = 现在即可调用。实时可用列表以控制台为准。</Note>

## 精选图片模型

| 模型                                                          | 状态      | 定位   | 价格(\$/张) | 速度       | 适用                      |
| ----------------------------------------------------------- | ------- | ---- | -------- | -------- | ----------------------- |
| [Nano Banana Pro](/image-generation/models/nano-banana-pro) | ✅ 可用    | 海外明星 | \$0.12   | —        | 主力旗舰 · 高质量文生图 · 海外份额最高  |
| [Nano Banana](/image-generation/models/nano-banana)         | ✅ 可用    | 海外明星 | \$0.035  | —        | 性价比版 · 日常批量文生图          |
| [Z-Image Turbo](/image-generation/models/z-image-turbo)     | ✅ 可用    | 海外明星 | \$0.015  | 0.9-2.2s | 跨境电商主图 · 极致性价比          |
| [FLUX 1.1 Pro](/image-generation/models/flux-1.1-pro)       | 🔜 即将上线 | 海外明星 | —        | 4.4-6.0s | 高质量精细化 · 漫剧角色           |
| [Seedream 5.0 Lite](/image-generation/models/seedream-v4)   | ✅ 可用    | 国产   | \$0.045  | —        | 亚洲脸 · 小红书风格 · 文生图主力     |
| [通义万相 2.7 Image Pro](/image-generation/models/wan-v2.7)     | ✅ 可用    | 国产   | 以控制台为准   | —        | 国产主力 · 原生支持负向提示词        |
| [FLUX Dev](/image-generation/models/flux-dev)               | 🔜 即将上线 | 开源   | —        | 2.3-4.4s | 测试 · 通用场景               |
| [FLUX Schnell](/image-generation/models/flux-schnell)       | 🔜 即将上线 | 开源   | —        | 0.9-2.9s | 大批量出图 · 4 步极速           |
| [GPT-Image-1](/image-generation/models/gpt-image-1)         | ✅ 可用    | L2兜底 | 以控制台为准   | —        | 兜底 · 指令遵循强 · 文生图和编辑能力规划 |

> 这张表用于解释重点模型定位。主流模型方向见 [主流模型](/models/mainstream-models)，完整价格见 [价格页](/pricing)。

## 公开入口

* **主路径 · OpenAI 兼容** — `POST /v1/images/generations`，已有 OpenAI SDK 代码改 base\_url 即用
* **高级入口 · 当前有边界** — `POST /v1/tapapi/images/advanced`，仅用于已确认字段；图生图、多参考图、webhook 暂不开放
* **编辑接口 · 条件可用** — `POST /v1/images/edits`，仅在模型明确支持图片编辑协议时使用

## 当前接入原则

| 原则          | 说明                                             |
| ----------- | ---------------------------------------------- |
| 先用文生图主路径    | 生产优先接 `POST /v1/images/generations`，不要一开始走高级字段 |
| 结果同时兼容两种格式  | 返回项可能是 `url`，也可能是 `b64_json`                   |
| `n` 先从 1 开始 | 批量任务建议业务侧单张循环，方便记录每张图状态和成本                     |
| 记录请求 ID     | 每次请求保存响应头 `X-Oneapi-Request-Id`，方便排障和对账        |
| 不承诺未验证能力    | `image_urls`、多参考图、webhook 等能力未稳定前不要写进生产请求      |

当 `n > 1` 且渠道使用 fan-out 聚合时，返回数量可能少于请求数量。生产代码要检查 `data.length`，并识别可能出现的 `metadata.tapapi_partial`，详见 [批量生成](/image-generation/batch-generation)。