创建／编辑图片

POST/v1beta/models/{model}:generateContent

根据提示词生成图片，或在同一请求中传入参考图进行编辑。

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

model*string

平台图片模型 ID。

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

contents*array<>

按顺序传入当前请求和可选历史。多轮编辑时，将上一轮模型的 content 原样加入历史，保留各部分的 thoughtSignature。

Items1 <= items

generationConfig?

图片输出配置。

Response Body

`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 图片生成与编辑指南查看图片请求、响应和多轮编辑说明。

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`