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" - 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的任務式圖片生成與編輯接口 - 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 的異步任務接口 |
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