生图模型Gemini Native
gemini-3.1-flash-image
支持 512 / 1K / 2K / 4K 原生图像生成
能力概览
参考图最多 14 张
主体保持最多 10 个物体、4 个角色
内联请求参考图与文本合计小于 20 MB
生成与编辑图像
POST
https://www.yunqiai.chat/v1beta/models/gemini-3.1-flash-image:generateContent生成与编辑共用 Gemini Generate Content：只传文字时生成图片，加入 inlineData 参考图时进行编辑。
请求参数与范围
| 参数 | 类型 | 说明 |
|---|---|---|
contents必填 | array | 文本与参考图片输入；图片使用 inlineData |
contents[].role | string | user 或 model；单轮请求可省略，多轮编辑按对话顺序填写 |
contents[].parts[].text | string | 提示词；输入上下文最多 131,072 tokens |
contents[].parts[].inlineData | object | Base64 参考图；可与 text 放在同一个 parts 数组中 |
systemInstruction | object | 可选系统指令；计入输入上下文与请求体大小 |
generationConfig.responseModalities | string[] | TEXT、IMAGE 或二者；只要图片可设为 ["IMAGE"] |
generationConfig.imageConfig.aspectRatio | string | 1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9 |
generationConfig.imageConfig.imageSize | string | 512、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.1 Flash Image 可生成 512、1K、2K、4K 图片。
| 宽高比 | 512 | 1K | 2K | 4K |
|---|---|---|---|---|
1:1 | 512×512 | 1024×1024 | 2048×2048 | 4096×4096 |
1:4 | 256×1024 | 512×2048 | 1024×4096 | 2048×8192 |
1:8 | 192×1536 | 384×3072 | 768×6144 | 1536×12288 |
2:3 | 424×632 | 848×1264 | 1696×2528 | 3392×5056 |
3:2 | 632×424 | 1264×848 | 2528×1696 | 5056×3392 |
3:4 | 448×600 | 896×1200 | 1792×2400 | 3584×4800 |
4:1 | 1024×256 | 2048×512 | 4096×1024 | 8192×2048 |
4:3 | 600×448 | 1200×896 | 2400×1792 | 4800×3584 |
4:5 | 464×576 | 928×1152 | 1856×2304 | 3712×4608 |
5:4 | 576×464 | 1152×928 | 2304×1856 | 4608×3712 |
8:1 | 1536×192 | 3072×384 | 6144×768 | 12288×1536 |
9:16 | 384×688 | 768×1376 | 1536×2752 | 3072×5504 |
16:9 | 688×384 | 1376×768 | 2752×1536 | 5504×3072 |
21:9 | 792×168 | 1584×672 | 3168×1344 | 6336×2688 |
常用参数组合
| imageConfig | 输出尺寸 |
|---|---|
512 · 1:1 | 512×512 |
1K · 16:9 | 1376×768 |
2K · 3:2 | 2528×1696 |
4K · 1:1 | 4096×4096 |
比例怎么选
| 宽高比 | 适合场景 |
|---|---|
1:1 | 头像、商品主图、社交媒体方图 |
3:2 / 2:3 | 照片、横版或竖版构图 |
4:3 / 3:4 | 演示配图、文章插图 |
16:9 / 9:16 | 横版封面、竖版短视频封面 |
21:9 | 超宽横幅 |
1:4 / 4:1 / 1:8 / 8:1 | 长条海报、页面横幅 |
参考图生成
把参考媒体放在 parts 中，再写清楚要保留和要修改的内容。输出图片仍从 inlineData.data 读取。
| 能力 | 可用范围 |
|---|---|
| 参考图总数 | 最多 14 张 |
| 物体保持 | 最多 10 个 |
| 人物一致性 | 最多 4 个角色 |
| 风格参考 | 随参考图一并描述 |
{
"contents": [
{
"parts": [
{
"text": "保留主体，把背景改成夜景"
},
{
"inlineData": {
"mimeType": "image/png",
"data": "BASE64_IMAGE_DATA"
}
}
]
}
],
"generationConfig": {
"responseModalities": [
"IMAGE"
],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "512"
}
}
}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": "512"
}
}
}请求示例
curl --request POST \
--url https://www.yunqiai.chat/v1beta/models/gemini-3.1-flash-image: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": "512"
}
}
}'响应结构
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "BASE64_IMAGE_DATA"
}
}
]
},
"finishReason": "STOP"
}
],
"modelVersion": "gemini-3.1-flash-image"
}协议参考
本页示例按 YunQi AI 的模型 ID、接口路径和参数格式编写；以下链接提供对应协议的字段说明。