Image API — Choose the Model and Endpoint
Compare GPT Image 2 / 2.5, Gemini Flash Image and Seedream image endpoints. Use multipart edits for GPT reference images and follow each model's own input format.
图像 API 概览
APIMaster 通过 https://apimaster.ai/v1 提供图像 API。图生图并不存在适用于所有模型的统一输入格式。 请先选择模型，然后使用其文档中记载的端点和参考图像字段。
模型与端点指南
| 模型 | 文生图 | 图生图 | 指南 |
|---|---|---|---|
gpt-image-2 |
JSON /images/generations |
Multipart /images/edits，image / image[] 文件 |
GPT Image 2 / 2.5 |
gpt-image-2.5-sunburst |
JSON /images/generations |
Multipart /images/edits，image / image[] 文件 |
GPT Image 2 / 2.5 |
gpt-image-2.5-flare |
JSON /images/generations |
Multipart /images/edits，image / image[] 文件 |
GPT Image 2 / 2.5 |
gemini-3.1-flash-image-preview |
JSON /images/generations |
JSON /images/generations，配合 image_urls |
Gemini Flash Image |
grok-imagine-image-2.0 |
JSON /images/generations |
JSON /images/generations，image_urls（最多 5 张） |
Grok Imagine Image 2.0 |
doubao-seedream-5-0-pro-260628 |
JSON /images/generations |
JSON /images/generations，配合 image |
Seedream 5.0 Pro |
midjourney-v8.2 |
异步 /midjourney/generations |
JSON image_urls 参考图 |
Midjourney v8.2 / Niji 7 |
midjourney-niji-7 |
异步 /midjourney/generations |
JSON image_urls 参考图 |
Midjourney v8.2 / Niji 7 |
对于 Grok Imagine Image 2.0，请使用同步 /images/generations 和 image_urls。该模型不支持客户端 /images/generations/async 或 /images/edits；详见 Grok Imagine Image 2.0。
对于 GPT 参考图像，请将实际文件上传至 /images/edits 以获取图像响应，或上传至 /images/edits/async 以获取任务响应；不要照搬 Gemini 或 Seedream 的 JSON 格式。在提示词中提及参考图像并不等于上传。GPT Image 2.5 是一个独立的模型系列，并非 GPT Image 2 的别名。
Midjourney v8.2 和 Niji 7 使用 /midjourney/generations 创建异步任务，再通过 GET /tasks/{task_id} 轮询；请求示例和参数差异见 Midjourney v8.2 / Niji 7。
身份验证与响应
- 在控制台中创建密钥，并发送
Authorization: Bearer YOUR_API_KEY。 - JSON 生成调用使用
Content-Type: application/json。对于 multipart 编辑，请让 HTTP 客户端自动生成 Content-Type 和 boundary。 - 同步图像响应包含
data[]，其取值为url或b64_json；请同时处理这两种格式。请及时下载临时 URL。 - 可选字段、参考图像数量限制、尺寸和价格取决于模型及可用路由。请查看模型指南和市场页面。
异步任务
POST /images/generations/async、POST /images/edits/async 和 GET /tasks/{task_id}?model=MODEL_ID 为受支持的模型提供基于任务的图像工作流。这并非适用于所有图像操作的通用模式：
- 对于 GPT Image 2、Sunburst 和 Flare，文生图使用 JSON
generations/async，编辑使用 multipartedits/async。上传与同步编辑相同的文件，然后使用提交任务时所用账号和相同的模型 ID 进行轮询。 - 异步提交返回任务 ID 之前，生成或编辑可能已经完成；不要假设提交是即时完成的。轮询过程中不要重复提交已存在的任务。完成状态可以是
succeeded、success或completed；受跟踪的结果使用字符串类型的url，而旧版结果可能包含 URL 数组。 - Gemini 有自己的异步生成流程；关于参考图像输入，请遵循其指南。
- Seedream 5.0 Pro 使用同步生成方式，不支持
/images/generations/async。
完整的 cURL/Python 示例、轮询状态和故障排查，请参阅各模型指南。仅有 HTTP 200 响应并不能验证参考图像的还原度。