> ## 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.

# 图片模型

> 文生图、图生图、图片编辑和批量图片生成选型

图片模型当前以文生图公开接入为主。图生图、多参考图和图片编辑按具体模型逐步开放，不要把未确认字段直接写进默认生产请求。

<Note>控制台和价格页显示的是实时可用模型、账号权限和价格。文档里的图片模型详情页用于解释精选模型定位，不代表控制台实时可见的全部模型。</Note>

## 当前库存口径

图片模型已经是 Tapapi 的重点能力之一。文档详情页只精选 Nano Banana、Z-Image、GPT-Image、FLUX、Seedream、Wan 等主流方向，方便解释定位和接入边界；完整实时列表以控制台和价格页为准。

## 当前边界

| 能力           | 状态     | 建议                                         |
| ------------ | ------ | ------------------------------------------ |
| 文生图          | 当前公开主线 | 优先用 [文生图](/image-generation/text-to-image) |
| 图生图          | 按模型确认  | 只在模型文档明确支持时传图片输入                           |
| 多参考图         | 按模型确认  | 等待明确白名单、字段和计费说明                            |
| 图片编辑         | 条件能力   | 仅在模型明确支持时使用编辑字段                            |
| 异步 / webhook | 受限能力   | 默认用业务侧队列实现异步体验                             |

## 选择维度

| 维度      | 为什么重要                        |
| ------- | ---------------------------- |
| 画质      | 决定终稿可用率和人工返工量                |
| 速度      | 影响前端等待、批量吞吐和队列长度             |
| 成本      | 高频批量任务要看单张成本和失败返还            |
| 尺寸 / 比例 | 商品图、封面、广告图通常有固定画幅            |
| 中文理解    | 中文 prompt、中文文字和本土风格需要单独测试    |
| 主体稳定    | 商品图、人像和角色图最容易因为主体漂移返工        |
| 输出格式    | 是否返回 URL、base64、任务 ID，决定存储设计 |

## 场景推荐

| 场景         | 推荐方向             | 生产注意                |
| ---------- | ---------------- | ------------------- |
| 批量草图 / 预览  | 低成本、速度快的图片模型     | 默认 `n: 1`，用队列控并发    |
| 商品主图       | 商品主体稳定、背景干净的模型   | 关注主体完整、白底和转存        |
| 高质量精修      | 画质更强、指令遵循更好的模型   | 成本更高，建议人工审核         |
| 社媒 / 小红书风格 | 本土审美、人像表现较好的模型   | 先用真实素材 prompt 小样本测试 |
| 广告图 / 封面   | 构图、文字区域和风格一致性    | 记录返工率，不只看单张样例       |
| 图片编辑       | 明确支持图片输入和编辑字段的模型 | 未确认字段不要进生产          |

## 推荐组合

| 组合    | 用法                   |
| ----- | -------------------- |
| 默认模型  | 覆盖大多数常规图片请求          |
| 低成本模型 | 批量草稿、预览、低价值任务        |
| 高质量模型 | 付费用户、终稿、人工审核流程       |
| 兜底模型  | 默认模型失败、维护或效果明显不稳定时切换 |

## 详情页和实时模型的关系

图片模型详情页由文档仓库的图片模型数据生成，方便说明模型定位、支持能力和推荐场景。它不是实时库存，也不等同于你账号当前可调用的模型列表。

| 信息           | 以哪里为准     |
| ------------ | --------- |
| 当前能不能调用      | 控制台 / 价格页 |
| 当前价格和分组      | 控制台 / 价格页 |
| 更多图片模型       | 控制台 / 价格页 |
| 图片模型定位说明     | 模型详情页     |
| 图片 API 字段和示例 | 图片 API 文档 |
| 失败、超时和重试策略   | 上线指南      |

## 入口

* [图片生成概览](/image-generation/overview)
* [模型对比](/models/comparison)
* [文生图](/image-generation/text-to-image)
* [图生图](/image-generation/image-to-image)
* [多参考图](/image-generation/multi-reference)

## 生产检查

* 是否同时兼容 `url` 和 `b64_json`
* 是否把图片转存到自有对象存储
* 是否记录业务 `task_id`、模型名、prompt、返回字段和 `X-Oneapi-Request-Id`
* 是否检查 `data.length` 和 `metadata.tapapi_partial`
* 是否为 429 / 临时 5xx / network timeout 设置有限重试
* 是否准备默认模型和兜底模型
* 是否明确失败、超时、审核拒绝时的扣费和返还规则
* 是否对每个候选模型做过 20-50 条真实 prompt 小样本评测