图片接口概览
LLMAPI 当前提供三类图片调用方式。同步接口按普通 API Key 的平台分组路由；异步生图需要绑定批量生图分组的生图 API Key。
| 场景 | 文档 | 接口 |
|---|---|---|
| OpenAI 同步生成图片 | OpenAI 生成图片 | POST /v1/images/generations |
| OpenAI 同步编辑图片 | OpenAI 编辑图片 | POST /v1/images/edits |
| Gemini native 图片或多模态 | Gemini Native 图片 | /v1beta/models... |
| 长耗时生产生图任务 | 异步生图 | POST /v1/images/tasks |
| 异步任务推送事件 | 任务事件 | GET /v1/images/tasks/events |
Key 与平台选择
| Key 类型 | 可用图片接口 | 说明 |
|---|---|---|
| 普通 API Key / OpenAI 分组 | /v1/images/generations、/v1/images/edits | 需要普通分组启用生图能力。 |
| 普通 API Key / Gemini 分组 | /v1beta/models/{model}:generateContent | 同步调用按 Gemini native 协议传参。 |
| 普通 API Key / Antigravity 分组 | /antigravity/v1beta/models... | 使用 Antigravity 专用账号池。 |
| 生图 API Key / 批量生图分组 | /v1/images/tasks、/v1/images/tasks/events | 用于长耗时异步生图，模型必须存在于批量生图分组中。 |
| 其他普通分组 | 不适用 OpenAI Images API | 不要把非 OpenAI 图片模型发到 /v1/images/generations。 |
接入建议
- 内部测试或短耗时 OpenAI 图片请求，使用同步 OpenAI 图片接口。
- 面向客户的长耗时任务，优先使用异步生图，并使用生图 API Key。
- Gemini 短耗时图片或多模态请求，可以使用
/v1beta/models...；生产环境长耗时生图可使用/v1/images/tasks，模型名使用gemini-2.5-flash-image或gemini-3.1-flash-image。 - 如果出现
Images API is not supported for this platform，说明当前 Key 分组不是 OpenAI 平台，不能调用 OpenAI Images API。