Gemini 3.1 Pro

リクエスト ID gemini-3.1-pro-preview

プロトコル

POST /v1beta/models/gemini-3.1-pro-preview:generateContent · Gemini generateContentの例
POST /v1beta/models/gemini-3.1-pro-preview:streamGenerateContent · Gemini streamGenerateContentの例

認証

リクエストには API キー管理の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。

Gemini · x-goog-api-key: YOUR_API_KEY

リクエストパラメータ

`POST /v1beta/models/gemini-3.1-pro-preview:generateContent`

項目	型	必須	説明
`model (path)`	`string`	必須	URL パスのモデル ID に `gemini-3.1-pro-preview` を指定します。
`contents`	`object[]`	必須	会話内容の順序付き配列です。各項目の入力は `parts` に入れます。
`contents[].role`	`string`	任意	メッセージの役割。ユーザー入力は `user`、履歴内のモデルの発言は `model` です。
`contents[].parts`	`object[]`	必須	コンテンツ項目に含まれるパートの配列です。テキストパートは `text` を使います。
`systemInstruction`	`object`	任意	システム指示オブジェクト。指示テキストは `parts[].text` に指定します。
`generationConfig.maxOutputTokens`	`integer`	任意	出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。
`generationConfig.temperature`	`number`	条件付き	サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。
`generationConfig.topP`	`number`	条件付き	累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。
`generationConfig.responseMimeType`	`string`	任意	出力の MIME タイプ。JSON 出力には `application/json` を指定します。
`generationConfig.responseJsonSchema`	`object`	条件付き	出力の JSON Schema。スキーマに対応する接続先で `responseMimeType: application/json` と一緒に使います。

`POST /v1beta/models/gemini-3.1-pro-preview:streamGenerateContent`

項目	型	必須	説明
`model (path)`	`string`	必須	URL パスのモデル ID に `gemini-3.1-pro-preview` を指定します。
`contents`	`object[]`	必須	会話内容の順序付き配列です。各項目の入力は `parts` に入れます。
`contents[].role`	`string`	任意	メッセージの役割。ユーザー入力は `user`、履歴内のモデルの発言は `model` です。
`contents[].parts`	`object[]`	必須	コンテンツ項目に含まれるパートの配列です。テキストパートは `text` を使います。
`systemInstruction`	`object`	任意	システム指示オブジェクト。指示テキストは `parts[].text` に指定します。
`generationConfig.maxOutputTokens`	`integer`	任意	出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。
`generationConfig.temperature`	`number`	条件付き	サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。
`generationConfig.topP`	`number`	条件付き	累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。
`generationConfig.responseMimeType`	`string`	任意	出力の MIME タイプ。JSON 出力には `application/json` を指定します。
`generationConfig.responseJsonSchema`	`object`	条件付き	出力の JSON Schema。スキーマに対応する接続先で `responseMimeType: application/json` と一緒に使います。
`?alt`	`string`	任意	クエリパラメータ。 `sse` を指定すると `streamGenerateContent` の結果を SSE で受け取ります。

リクエスト例

API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。

Gemini generateContent

bash

curl -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro-preview:generateContent' \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ]
}'

Gemini streamGenerateContent

bash

curl -N -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent?alt=sse' \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ]
}'

レスポンスの読み取り

Gemini generateContent · candidates[].content.parts[] からテキストを取得します。 JSON
Gemini streamGenerateContent · SSE レコードを順に解析し、candidates[].content.parts[] のテキストを連結します。 SSE

接続ガイド