文生图/编辑 API 参考

Nano Banana 系列(Gemini 生态图像模型)的接口参考。系列介绍与提示词技巧见 Nano Banana 生图。

文生图

POST https://api.4allapi.com/v1/images/generations

curl https://api.4allapi.com/v1/images/generations \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-portrait",
    "prompt": "杂志封面质感的人像,自然光,浅景深,画面下方写着\"OMNI\""
  }'

• 画幅与分辨率用型号后缀:-square / -portrait / -landscape / -three-four / -four-three,高清加 -2k;
• Gemini 系对画面文字渲染表现好,文字内容用引号写在提示词里。

图片编辑(以图改图)

POST https://api.4allapi.com/v1/images/edits

curl https://api.4allapi.com/v1/images/edits \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -F model="gemini-3.1-flash-image" \
  -F image="@ref.png" \
  -F prompt="同一人物改为冬季雪景全身照,保持面部特征一致"

• 多参考图按顺序传多个 image 字段,提示词说明各图角色(主体图/风格图);
• 人物/商品一致性场景优先走编辑接口而非重新文生图。

型号档位

档位	代表型号	特点
Pro	gemini-3.0-pro-image 系列	质量最高,细节与文字最稳
标准	gemini-3.1-flash-image 系列	质量/速度均衡,主力档
预览	gemini-3-pro-image	新能力抢先

实时在售型号与单价以模型广场为准; 响应结构与转存注意事项同 文生图 API 参考。