# Gemini 原生格式

來源: https://docs.aicentos.com/zh-TW/api/images/nano-banana/gemini

Language: zh-TW

圖像（Images）Nano Banana

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

## 驗證

將 API Key 存入環境變數 `AICENTOS_API_KEY`；shell 範例會將其值展開至 `Authorization: Bearer` 標頭。

在控制台「權杖管理」取得的 API 金鑰

位置：`header`

## 請求主體

`application/json`

TypeScript 型別定義

在 TypeScript 中使用 request body 型別

## 回應主體

###

`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 "Authorization: Bearer $AICENTOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{    "contents": [      {        "role": "user",        "parts": [          {            "text": "一隻穿太空衣的水豚漂浮在太空裡"          }        ]      }    ],    "generationConfig": {      "responseModalities": [        "IMAGE"      ]    }  }'
```

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