图片接口概览
LLMAPI 为短耗时请求提供同步图片接口,为生产环境长耗时任务提供任务 API。
| 场景 | 文档 | 接口 |
|---|---|---|
| OpenAI 同步生成图片 | OpenAI 生成图片 | POST /v1/images/generations |
| OpenAI 同步编辑图片 | OpenAI 编辑图片 | POST /v1/images/edits |
| Gemini 原生图片与多模态生成 | Gemini Native | POST /v1beta/models/{model}:generateContent |
| 长耗时生产图片任务 | 任务 API | POST /v1/tasks |
Key 与平台选择
| Key 类型 | 可用图片接口 | 说明 |
|---|---|---|
| 普通 API Key / OpenAI 分组 | /v1/images/generations、/v1/images/edits | 普通分组需要启用生图能力。 |
| 普通 API Key / Gemini 分组 | /v1beta/models/{model}:generateContent、/v1beta/models/{model}:streamGenerateContent | 使用 Gemini Native 请求体。 |
| 任务 API Key / 按模型档位 | /v1/tasks、/v1/tasks/events、/v1/images/generations、/v1/images/edits | OpenAI Images 兼容同步接口会等待图片结果;价格和路由按请求模型在这个 Key 上最终生效的档位执行。 |
| 其他普通分组 | 图片接口取决于分组平台 | 使用与当前平台匹配的接口。 |
接入建议
- 短耗时 OpenAI 图片请求可使用同步 OpenAI 图片接口。
- Gemini 图片和多模态请求使用 Gemini Native 接口。
- 面向客户的长耗时任务,优先使用 任务 API。
- 任务 API Key 调用 OpenAI Images 兼容同步接口时,同样使用请求模型在这个 Key 上的最终档位。请求中不要增加档位参数或修改模型名;使用这个 Key 调用
GET /v1/tasks/models可以查询可用模型和价格。 - 如果已有 OpenAI Images 客户端只能调用
/v1/images/generations或/v1/images/edits,也可以使用任务 API Key 保持相同请求格式。该接口同步等待最多 120 秒;如果超时响应包含task_id,请使用任务 API 查询最终状态。 - 如果看到
Images API is not supported for this platform,说明当前 Key 分组不能调用 OpenAI Images API。Gemini 分组请使用 Gemini Native。