建立／編輯圖片

POST/v1beta/models/{model}:generateContent

根據提示詞生成圖片，或在同一請求中傳入參考圖進行編輯。

授權

bearerAuth

授權Bearer <token>

傳遞位置: header

路徑參數

model*string

平台圖片模型 ID。

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

contents*array<>

按順序傳入當前請求和可選歷史。多輪編輯時，將上一輪模型的 content 原樣加入歷史，保留各部分的 thoughtSignature。

項目數1 <= items

generationConfig?

圖片輸出配置。

回應主體

`application/json`

curl -X POST "https://example.com/v1beta/models/MODEL_ID:generateContent" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "生成一張窗台上的橙色陶瓷花瓶照片，保留柔和的窗光和簡潔的背景。"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": [
        "IMAGE"
      ],
      "imageConfig": {
        "aspectRatio": "1:1"
      }
    }
  }'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_BYTES"
            },
            "thoughtSignature": "THOUGHT_SIGNATURE"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 23,
    "candidatesTokenCount": 1206,
    "totalTokenCount": 1925,
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 23
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 86
      },
      {
        "modality": "IMAGE",
        "tokenCount": 1120
      }
    ],
    "thoughtsTokenCount": 696
  },
  "modelVersion": "MODEL_ID",
  "createTime": "2026-11-06T18:28:55.590821Z",
  "responseId": "RESPONSE_ID"
}

Google Gemini 圖片生成與編輯指南查看圖片請求、回應和多輪編輯說明。

授權

路徑參數

請求主體

回應主體

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`