图片生成
本平台统一图片生成 API 规范
图片生成支持两种调用方式：OpenAI 兼容格式和 Gemini 原生格式。OpenAI 调用方式适合大多数业务和 OpenAI SDK；Gemini 调用方式适合已经按 Google Gemini SDK 或 generateContent 格式接入的客户端。
OpenAI 调用方式
这里的 OpenAI 指接口格式，不限制模型厂商。业务接入时优先使用 /v1/images/generations，需要兼容 OpenAI 图片编辑客户端时使用 /v1/images/edits。
文生图
POST /v1/images/generations{
"model": "gpt-image-2",
"prompt": "未来城市夜景，电影感，高细节",
"aspect_ratio": "16:9",
"resolution": "2k"
}如需用 OpenAI 格式调用 Gemini 图片模型，把 model 换成 gemini-3-pro-image 即可：
{
"model": "gemini-3-pro-image",
"prompt": "一张白底产品海报，玻璃质感，柔和棚拍光",
"size": "1024x1024",
"resolution": "2k"
}图生图
POST /v1/images/edits也可以在 /v1/images/generations 中传图片字段：
{
"model": "gpt-image-2",
"prompt": "保持主体不变，改成清晨自然光",
"image": "https://example.com/input.png",
"size": "1024x1024"
}Chat Completions 兼容
如果客户端只能调用 /v1/chat/completions，也可以用 OpenAI Chat Completions 格式调用 Gemini 图片模型。平台会为支持图片输出的 Gemini 模型补齐 responseModalities；图片比例和尺寸通过 extra_body.google.image_config 传入。
curl https://你的本平台域名/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image-preview",
"messages": [
{
"role": "user",
"content": "生成一张未来城市夜景，电影感，高细节"
}
],
"extra_body": {
"google": {
"image_config": {
"aspect_ratio": "16:9",
"image_size": "2K"
}
}
}
}'Gemini 调用方式
Gemini 原生格式使用 generateContent，请求体使用 Gemini 的 contents、generationConfig、imageConfig 字段。
curl https://你的本平台域名/v1beta/models/gemini-3-pro-image-preview:generateContent \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "生成一张未来城市夜景，电影感，高细节"
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "2K"
}
}
}'Gemini 原生令牌
Gemini 原生路由统一使用 Authorization: Bearer sk-...，这里填写的是本平台颁发的令牌。
统一字段
| 字段 | 类型 | 说明 |
|---|---|---|
model | string | 本平台图片模型值，必填。 |
prompt | string | 图片提示词，必填。 |
image / image_url / imageUrl | string | 单张图生图或参考图输入。 |
images / imageUrls | string[] | 多图输入；部分模型只支持 1 张。 |
aspect_ratio / aspectRatio | string | 画面比例，如 1:1、16:9、9:16、3:2。 |
size | string | OpenAI 风格尺寸，如 1024x1024；平台会尽量推导比例和分辨率。 |
resolution | string | 图片分辨率，如 1k、2k、4k。 |
negative_prompt | string | 反向提示词，只有部分模型支持。 |
图生图含义
当前启用图片模型的图生图是参考图能力，不等同于 OpenAI 带 mask 的局部编辑。
模型能力
| 模型值 | 系列 | 文生图 | 图生图 | 自动识别规则 | 限制 |
|---|---|---|---|---|---|
| gpt-image-2 | OpenAI Image | 支持 | 支持 | 无图片按文生图；有 image/images/imageUrl 按图生图或参考图。 | 支持 size 推导 aspectRatio/resolution；参考图字段会归一为 imageUrls。 |
| gemini-3-pro-image | Gemini Image | 支持 | 支持 | 无图片按文生图；有 image/images/imageUrl 按图生图或参考图。 | 支持 size 推导 aspectRatio/resolution；参考图字段会归一为 imageUrls。 |
图生图为参考图能力，不等同于带 mask 的局部编辑。
多图参考
{
"model": "gemini-3-pro-image",
"prompt": "参考两张图片的风格和主体，生成一张海报",
"imageUrls": ["https://example.com/reference-a.jpg", "https://example.com/reference-b.jpg"],
"aspect_ratio": "16:9"
}响应
{
"created": 1782658000,
"data": [
{
"url": "https://example.com/result.png",
"b64_json": "",
"revised_prompt": ""
}
]
}