画像の作成・編集

Gemini ネイティブ API で画像を生成、またはプロンプトで参照画像を編集します。

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`