gemini-3-pro-image ( nano banana pro )

本文介绍 gemini-3-pro-image-preview (模型ID: gemini-3-pro-image-preview) 模型调用 API 的输入输出参数，供您使用接口时查阅字段含义。

以下只展示部分使用到的字段说明，详细说明请参考官方文档 Gemini 3 Pro 图片功能的新变化

请求参数

请求体

字段名	类型	是否必须	默认值	描述
contents	array	必须	-	请求的内容，包含一个或多个部分。
contents.role	string	必须	”user”	内容的角色，此处固定为 “user”。
contents.parts	array	必须	-	内容的具体部分。
contents.parts.text	string	可选	-	提示词文本。
generationConfig	object	可选	-	生成配置。
generationConfig.responseModalities	array	可选	[“TEXT”, “IMAGE”]	期望的响应形式，可以是文本或图像。
generationConfig.imageConfig	object	可选	-	图片生成配置。
generationConfig.imageConfig.aspectRatio	string	可选	”1:1”	图片宽高比。支持 “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”	图片分辨率。支持 “1K”, “2K”, “4K”。

响应参数

字段名	类型	描述
candidates	`array`	返回的候选内容列表。
candidates.content	`object`	候选内容。
candidates.content.parts	`array`	内容的具体部分，可能包含文本和图像数据。
candidates.content.parts.text	`string`	模型返回的文本描述。
candidates.content.parts.inlineData	`object`	内联的图像数据。
candidates.content.parts.inlineData.data	`string`	Base64 编码的图像数据。
candidates.content.parts.inlineData.mimeType	`string`	数据的 MIME 类型，例如 “image/png”。
candidates.finishReason	`string`	生成结束的原因，例如 “STOP”。
usageMetadata	`object`	token 使用情况的元数据。
error	`Object`	错误信息对象

示例

Gemini 兼容接口

POST https://api.modelverse.cn/v1beta/models/gemini-3-pro-image-preview:generateContent

图片生成（文本转图片）

⚠️ 注意：您必须在配置中添加 responseModalities: [“TEXT”, “IMAGE”]。

curl

curl -s -X POST \
  "https://api.modelverse.cn/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: $MODELVAULTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Da Vinci style anatomical sketch of a dissected Monarch butterfly. Detailed drawings of the head, wings, and legs on textured parchment with notes in English."}]}],
    "tools": [{"google_search": {}}],
  "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}
    }
  }' | jq -r '.candidates[0].content.parts[] | select(.inlineData and (.thought | not)) | .inlineData.data' | head -1 | base64 --decode > butterfly.png

python

from google import genai
from google.genai import types
import os
 
client = genai.Client(
    api_key=os.getenv("MODELVAULTS_API_KEY", "<MODELVAULTS_API_KEY>"),  # 您的API_KEY
    http_options=types.HttpOptions(
        base_url="https://api.modelverse.cn"
    ),
)
 
prompt = "Da Vinci style anatomical sketch of a dissected Monarch butterfly. Detailed drawings of the head, wings, and legs on textured parchment with notes in English."
aspect_ratio = "1:1"  # "1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9"
resolution = "1K"  # "1K", "2K", "4K"
 
response = client.models.generate_content(
    model="gemini-3-pro-image-preview",
    contents=prompt,
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(
            aspect_ratio=aspect_ratio, image_size=resolution
        ),
    ),
)
 
for part in response.parts:
    # 跳过思考过程中的中间图片，只保留最终输出图片
    if getattr(part, "thought", False):
        continue
    if part.text is not None:
        print(part.text)
    elif image := part.as_image():
        image.save("butterfly.png")

响应示例

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Here is the anatomical sketch of a dissected Monarch butterfly in Da Vinci style..."
          },
          {
            "inlineData": {
              "data": "iVBORw0KGgoAAAANSUhEUgAA...",
              "mimeType": "image/png"
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "candidatesTokenCount": 1315,
    "totalTokenCount": 1331
  }
}

{
  "error": {
    "message": "error_message",
    "type": "error_type",
    "param": "request_id",
    "code": "error_code"
  }
}