生图模型Gemini Native
gemini-3-pro-image-preview
Nano Banana Pro 高质量图像生成
能力概览
参考图最多 14 张
一致性参考最多 6 个物体、5 个角色、3 张风格图
调用模型 IDgemini-3-pro-image-preview
生成与编辑图像
POST
https://www.yunqiai.chat/v1beta/models/gemini-3-pro-image-preview:generateContent生成与编辑共用 Gemini Generate Content：只传文字时生成图片，加入 inlineData 参考图时进行编辑。
请求参数与范围
| 参数 | 类型 | 说明 |
|---|---|---|
contents必填 | array | 文本与参考图片输入；图片使用 inlineData |
contents[].role | string | user 或 model；单轮请求可省略，多轮编辑按对话顺序填写 |
contents[].parts[].text | string | 提示词；输入上下文最多 65,536 tokens |
contents[].parts[].inlineData | object | Base64 参考图；可与 text 放在同一个 parts 数组中 |
systemInstruction | object | 可选系统指令；计入输入上下文与请求体大小 |
generationConfig.responseModalities | string[] | TEXT、IMAGE 或二者；只要图片可设为 ["IMAGE"] |
generationConfig.imageConfig.aspectRatio | string | 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9 |
generationConfig.imageConfig.imageSize | string | 1K、2K、4K；K 必须大写 |
safetySettings | array | 可选安全策略；不要同时为同一类别传入重复设置 |
inlineData.mimeType | string | image/png、image/jpeg、image/webp、image/heic、image/heif |
inlineData.data | string | 裸 Base64 数据，不包含 data:image/... 前缀 |
比例与实际像素
gemini-3-pro-image-preview 可生成 1K、2K、4K 图片。
| 宽高比 | 1K | 2K | 4K |
|---|---|---|---|
1:1 | 1024×1024 | 2048×2048 | 4096×4096 |
2:3 | 848×1264 | 1696×2528 | 3392×5056 |
3:2 | 1264×848 | 2528×1696 | 5056×3392 |
3:4 | 896×1200 | 1792×2400 | 3584×4800 |
4:3 | 1200×896 | 2400×1792 | 4800×3584 |
4:5 | 928×1152 | 1856×2304 | 3712×4608 |
5:4 | 1152×928 | 2304×1856 | 4608×3712 |
9:16 | 768×1376 | 1536×2752 | 3072×5504 |
16:9 | 1376×768 | 2752×1536 | 5504×3072 |
21:9 | 1584×672 | 3168×1344 | 6336×2688 |
常用参数组合
| imageConfig | 输出尺寸 |
|---|---|
1K · 1:1 | 1024×1024 |
2K · 3:2 | 2528×1696 |
4K · 9:16 | 3072×5504 |
参考图生成
把参考媒体放在 parts 中，再写清楚要保留和要修改的内容。输出图片仍从 inlineData.data 读取。
| 能力 | 可用范围 |
|---|---|
| 参考图总数 | 最多 14 张 |
| 物体保持 | 最多 6 个 |
| 人物一致性 | 最多 5 个角色 |
| 风格参考 | 最多 3 张 |
{
"contents": [
{
"parts": [
{
"text": "保留主体，把背景改成夜景"
},
{
"inlineData": {
"mimeType": "image/png",
"data": "BASE64_IMAGE_DATA"
}
}
]
}
],
"generationConfig": {
"responseModalities": [
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "1K"
}
}
}Base64 参考图
输入字段只放裸 Base64；输出位于 candidates[].content.parts[].inlineData.data。
{
"contents": [
{
"parts": [
{
"text": "保留主体，把背景改成夜景"
},
{
"inlineData": {
"mimeType": "image/png",
"data": "BASE64_IMAGE_DATA"
}
}
]
}
],
"generationConfig": {
"responseModalities": [
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "1K"
}
}
}请求示例
curl --request POST \
--url https://www.yunqiai.chat/v1beta/models/gemini-3-pro-image-preview:generateContent \
--header "x-goog-api-key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"contents": [
{
"parts": [
{
"text": "生成一张雨后的未来城市，霓虹倒影，电影感构图"
}
]
}
],
"generationConfig": {
"responseModalities": [
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "1K"
}
}
}'响应结构
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "BASE64_IMAGE_DATA"
}
}
]
},
"finishReason": "STOP"
}
],
"modelVersion": "gemini-3-pro-image-preview"
}协议参考
本页示例按 YunQi AI 的模型 ID、接口路径和参数格式编写；以下链接提供对应协议的字段说明。