图像(Images)Nano Banana

Gemini 原生格式

POST
/v1beta/models/gemini-3-pro-image-preview:generateContent

鉴权

bearerAuth
鉴权Bearer <token>

在控制台「令牌管理」获取的 API Key

位置: header

请求体

application/json

TypeScript 类型定义

在 TypeScript 中使用 request body 类型

响应体

application/json

curl -X POST "https://example.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "role": "user",        "parts": [          {            "text": "一只穿宇航服的水豚漂浮在太空里"          }        ]      }    ],    "generationConfig": {      "responseModalities": [        "IMAGE"      ]    }  }'
{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [
          {
            "text": "string",
            "inlineData": {
              "mimeType": "string",
              "data": "string"
            }
          }
        ]
      },
      "finishReason": "string",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  },
  "modelVersion": "string"
}