# Gemini 原生格式

来源: https://docs.aicentos.com/api/images/nano-banana/gemini

Language: zh-CN

> Nano Banana 2 的 Gemini 原生图像生成接口：端点与请求示例

Nano Banana 2 的 Gemini 原生格式接口。

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

## 鉴权

Bearer Token：API Key 在控制台「令牌管理」获取，放在请求头 `Authorization`。

## 请求

`Content-Type: application/json`

```bash
export AICENTOS_API_KEY="sk-your-aicentos-api-key"

curl -X POST "https://aicentos.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AICENTOS_API_KEY" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{ "text": "一只穿宇航服的水豚漂浮在太空里" }]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'
```

`generationConfig.responseModalities` 设为 `IMAGE` 时返回图像。

## 响应

生成的图像在 `candidates[0].content.parts` 里，以 `inlineData`（base64）返回：

```json
{
  "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"
}
```