Skip to main content

​
模型映射关系

内部代号官方/API 名称特点文档链接
Nano Banana 2gemini-3.1-flash-image-preview主打速度与主流高质量，目前的默认模型Gemini 3.1 Flash 文档
Nano Banana Progemini-3-pro-image-preview主打极致质量，Pro/高级选项当前文档
注意： gemini-3.1-flash-image-preview (Nano Banana 2) 使用不同的 API 格式，请查看专门的 Gemini 3.1 Flash 文档。

​
支持的模型

gemini-3-pro-image-preview

标准分辨率版本

gemini-3-pro-image-preview-2k

2K 分辨率版本

gemini-3-pro-image-preview-4k

4K 高清分辨率版本

​
文生图

通过文本描述生成图片。
配置说明：
  • 将 api.xxx.com 替换为您的实际 API 域名
  • 将 sk-xxx 替换为您的 API 密钥（可在控制台获取）
curl -X POST "https://api.xxx.com/v1/images/generations" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "请为黑客帝国设计一张高品质的3D海报,需要先检索影视剧/小说信息和著名的片段场景。首先,请利用你的知识库检索这个影视剧/小说的内容,找出一个最具代表性的名场面或核心地点。在画面中央,将这个场景构建为一个精致的轴侧视角3D微缩模型。风格要采用梦工厂动画那种细腻、柔和的渲染风格。你需要还原当时的建筑细节、人物动态以及环境氛围,无论是暴风雨还是宁静的午后,都要自然地融合在模型的光影里。关于背景,不要使用简单的纯白底。请在模型周围营造一种带有淡淡水墨晕染和流动光雾的虚空环境,色调雅致,让画面看起来有呼吸感和纵深感,衬托出中央模型的珍贵。最后是底部的排版,请生成中文文字。居中写上小说名称,字体要有与原著风格匹配的设计感。在书名下方,自动检索并排版一句原著中关于该场景的经典描写或台词,字体使用优雅的衬线体。整体布局要像一个高级的博物馆藏品铭牌那样精致平衡。",
    "size": "1x1",
    "n": 1
  }'

​
参数说明

​
常用参数

参数名类型必填说明默认值/可选值
modelstring✅模型名称gemini-3-pro-image-preview, gemini-3-pro-image-preview-2k, gemini-3-pro-image-preview-4k
promptstring✅文本提示词支持中英文，建议详细描述
imagestring/array❌输入图片图生图/多图融合时使用，支持 URL 或 Base64
sizestring❌图片尺寸1:1, 16:9, 9:16 等比例格式
response_formatstring❌响应格式url(链接), b64_json(Base64), 默认url
ninteger❌生成图片数量默认为 1

​
图生图 (Base64)

基于输入图片生成新图片，支持 Base64 格式上传。 
curl -X POST "https://api.xxx.com/v1/images/generations" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "将这张图转换为油画风格",
    "size": "1:1",
    "response_format": "url",
    "n": 1,
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  }'
图片输入格式： 支持 Base64 编码，格式为 data:image/jpeg;base64,<base64_data>

​
多图融合 (URL)

融合多张图片的特征生成新图片，支持 URL 格式上传。 
curl -X POST "https://api.xxx.com/v1/images/generations" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "将图1的服装换为图2的服装",
    "image": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png",
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_2.png"
    ],
    "size": "1:1",
    "response_format": "url",
    "n": 1
  }'
多图融合支持： image 参数可以传入数组，支持多张图片的 URL
返回的图片URL通常有24小时的有效期，请及时下载保存。