Gemini Generate Content

GeminiのContentとPartsを使用して、テキスト、マルチモーダル、ツール、コード実行のレスポンスを作成します。

Generate Content APIは、ContentとPartsを使用して、テキスト、マルチモーダル入力、関数呼び出し、コード実行のリクエストを表現します。生成結果はCandidates、Usage Metadata、安全性情報として返されます。リクエストではBearer API Key認証を使用します。対応する入力モダリティ、ツール、高度な生成パラメーターは、選択したモデルによって異なります。

POST/v1beta/models/{model}:generateContent

Gemini の Content と Parts 構造を使用して、テキスト、マルチモーダル、関数呼び出し、またはコード実行のレスポンスを生成します。

認証

bearerAuth

認証Bearer <token>

Authorization Header に Bearer your-api-key を指定します。

指定位置: header

パスパラメーター

model*string

コンテンツ生成に使用するモデル ID です。パスでは自動的に models/{model} の形式になります。

デフォルト値"MODEL_ID"

リクエストボディ

Gemini は Content と Parts を使用して、テキスト、マルチモーダル入力、ツール、生成設定を表現します。

application/json

テキストチャット

user と model の Content を使用して、単一ターンまたは複数ターンのテキスト会話を構成します。

contents[]: 時系列順に並べた会話コンテンツです。
parts[].text: 各メッセージのテキストコンテンツです。
role: メッセージの作成者です。通常は user または model を使用します。

application/json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "こんにちは。自己紹介してください。"
        }
      ]
    }
  ]
}

Contentオブジェクトとtext Partを使用して、単一ターンまたは複数ターンのテキスト会話を構成します。

contents*array<>

時系列順に並べたテキスト Content です。各メッセージは parts[].text で内容を指定します。

項目数1 <= items

tools?array<>

モデルが使用できる関数、コード実行、検索、URL Context、File Search、MCP などのツールです。

toolConfig?

リクエスト内のツール呼び出し設定です。

safetySettings?array<>

安全性カテゴリーごとにコンテンツのブロックしきい値を設定します。

systemInstruction?

開発者が設定する system 指示です。現在はテキストコンテンツのみ対応します。

generationConfig?

モデルの生成および出力設定です。

cachedContent?string

コンテキストとして使用するキャッシュ済みコンテンツ名です。形式は cachedContents/{cachedContent} です。

serviceTier?ServiceTier

リクエストで使用したサービス階層です。

指定可能な値

"unspecified"
"standard"
"flex"
"priority"

store?boolean

現在のリクエストに対するログ記録を制御します。指定した場合はプロジェクト単位のログ設定より優先されます。

レスポンスボディ

`application/json`

curl -X POST "https://example.com/v1beta/models/MODEL_ID:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "role": "user",        "parts": [          {            "text": "こんにちは。自己紹介してください。"          }        ]      }    ]  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "こんにちは。私は質問への回答やタスクの実行を支援する AI アシスタントです。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE",
          "blocked": false
        }
      ],
      "tokenCount": 24
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {
        "category": "HARM_CATEGORY_HARASSMENT",
        "probability": "NEGLIGIBLE"
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 24,
    "totalTokenCount": 32,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 8
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 24
      }
    ]
  },
  "modelVersion": "MODEL_ID",
  "responseId": "response-example"
}

Google Gemini Generate Content公式ドキュメントアップストリームプロトコルの定義と最新のフィールド変更を確認します。

認証

パスパラメーター

リクエストボディ

レスポンスボディ

200application/json

400application/json

401application/json

403application/json

404application/json

413application/json

429application/json

500application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`