API ReferenceImage APIs
Image APIs
本分组用于说明 ReachAPI 对外提供的图片生成接口。
本分组当前有三类接口形态：
seedream-4-5、seedream-5-0-lite、seedream-5-0-pro、nanobanana、nanobanana-2、nanobanana-pro这组任务式图片接口使用POST /v1/images/create- GPT Image 2 异步图片接口使用
POST /v1/images/create，请求中传model: "gpt-image-2-async" - GPT Image 2.5 内部预览接口可使用
/v1/images/generations与/v1/images/edits发起同步请求，或使用POST /v1/images/create创建异步任务 - OpenAI Image API 兼容接口使用
model: "gpt-image-2"调用/v1/images/generations和/v1/images/edits - 任务式接口通过
GET /v1/tasks/{task_id}查询状态 - 可选传入
callback_url接收终态回调 - 任务成功后，从
data[].url读取生成结果
当前可用文档：
- OpenAI Image API 兼容接口：兼容 OpenAI 图片生成与编辑接口，当前推荐模型为
gpt-image-2 - GPT Image 2 异步图片接口：使用
gpt-image-2-async的任务式图片生成与编辑接口 - GPT Image 2.5 图片接口：同时支持同步生成、同步编辑和异步任务的 Flare 与 Sunburst 内部预览接口
- Seedream：支持文生图、图像编辑与批量连续生成，仅支持 URL 图片输入
- nanobanana：支持文生图和轻量图像编辑，最多 5 张参考图，不支持
resolution与联网搜索 - nanobanana-2：支持文生图、图像编辑与搜索增强生成，比例与分辨率选项更丰富
- nanobanana-pro：面向更高质量输出的图片生成与编辑能力
能力对比
| 模型 ID | 典型用途 | 最大参考图数量 | resolution | enable_web_search | 说明 |
|---|---|---|---|---|---|
nanobanana | 文生图、图像编辑 | 5 | 不支持 | 不支持 | 更适合少量参考图场景 |
gpt-image-2-async | 文生图、图像编辑 | 14 | 1k、2k、4k | 不支持 | GPT Image 2 的异步任务接口 |
gpt-image-2.5-flare / gpt-image-2.5-sunburst | 快速生成 / 精确编辑 | 14 | 1k、2k、4k | 不支持 | 内部预览；支持六档质量 |
seedream-4-5 / seedream-5-0-lite | 文生图、图像编辑、批量连续生成 | 14 | 按模型支持 2k、3k、4k | 不支持 | 仅支持 URL 图片输入，不支持 aspect_ratio |
seedream-5-0-pro | 文生图、多参考图生成、交互式编辑 | 10 | 1k、2k | 不支持 | 支持自由标记和坐标编辑，仅支持 URL 图片输入 |
nanobanana-2 | 文生图、图像编辑、实时信息增强生成 | 14 | 0.5k、1k、2k、4k | 支持 | 支持更宽和更长的画面比例 |
nanobanana-pro | 高质量文生图、高质量图像编辑 | 14 | 1k、2k、4k | 支持 | 更偏向高质量输出选择 |
通用约定
- 基础域名：
https://direct.reachapi.ai - 认证方式：在请求头中传
Authorization: Bearer YOUR_REACH_API_KEY - Content-Type：
application/json - 任务结果主契约：最终图片地址返回在
data[].url - 平台通用规则：
/docs/api-reference/reference-overview - 本地文件上传：
/docs/api-reference/file/upload