图片模型 - Tapapi 文档

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

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

当前库存口径

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

当前边界

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

选择维度

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

场景推荐

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

推荐组合

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

详情页和实时模型的关系

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

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

入口

生产检查

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