Gemini 3.8 Flash

リクエスト ID gemini-3.8-flash

プロトコル

POST /v1beta/models/gemini-3.8-flash:generateContent · Gemini generateContentの例
POST /v1beta/models/gemini-3.8-flash:streamGenerateContent · Gemini streamGenerateContentの例

認証

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

Gemini · x-goog-api-key: YOUR_API_KEY

リクエストパラメータ

`POST /v1beta/models/gemini-3.8-flash:generateContent`

項目	型	必須	説明
`model (path)`	`string`	必須	URL パスのモデル ID に `gemini-3.8-flash` を指定します。
`contents`	`object[]`	必須	会話内容の順序付き配列です。各項目の入力は `parts` に入れます。
`contents[].role`	`string`	任意	メッセージの役割。ユーザー入力は `user`、履歴内のモデルの発言は `model` です。
`contents[].parts`	`object[]`	必須	コンテンツ項目に含まれるパートの配列です。テキストパートは `text` を使います。
`contents[].parts[].inlineData`	`object`	条件付き	インラインメディアのオブジェクト。 `mimeType` と Base64 でエンコードした `data` を指定します。対応メディアはモデルと接続先によって異なります。
`systemInstruction`	`object`	任意	システム指示オブジェクト。指示テキストは `parts[].text` に指定します。
`generationConfig.maxOutputTokens`	`integer`	任意	出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。
`generationConfig.responseMimeType`	`string`	任意	出力の MIME タイプ。JSON 出力には `application/json` を指定します。
`generationConfig.responseJsonSchema`	`object`	条件付き	出力の JSON Schema。スキーマに対応する接続先で `responseMimeType: application/json` と一緒に使います。
`tools`	`object[]`	条件付き	モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。

`POST /v1beta/models/gemini-3.8-flash:streamGenerateContent`

項目	型	必須	説明
`model (path)`	`string`	必須	URL パスのモデル ID に `gemini-3.8-flash` を指定します。
`contents`	`object[]`	必須	会話内容の順序付き配列です。各項目の入力は `parts` に入れます。
`contents[].role`	`string`	任意	メッセージの役割。ユーザー入力は `user`、履歴内のモデルの発言は `model` です。
`contents[].parts`	`object[]`	必須	コンテンツ項目に含まれるパートの配列です。テキストパートは `text` を使います。
`contents[].parts[].inlineData`	`object`	条件付き	インラインメディアのオブジェクト。 `mimeType` と Base64 でエンコードした `data` を指定します。対応メディアはモデルと接続先によって異なります。
`systemInstruction`	`object`	任意	システム指示オブジェクト。指示テキストは `parts[].text` に指定します。
`generationConfig.maxOutputTokens`	`integer`	任意	出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。
`generationConfig.responseMimeType`	`string`	任意	出力の MIME タイプ。JSON 出力には `application/json` を指定します。
`generationConfig.responseJsonSchema`	`object`	条件付き	出力の JSON Schema。スキーマに対応する接続先で `responseMimeType: application/json` と一緒に使います。
`tools`	`object[]`	条件付き	モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。
`?alt`	`string`	任意	クエリパラメータ。 `sse` を指定すると `streamGenerateContent` の結果を SSE で受け取ります。

リクエスト例

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

Gemini generateContent

bash

curl -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.8-flash: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.8-flash: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

接続ガイド

機能と制限

streaming · 対応
tool_calling · 条件付き対応 — 互換プロトコルとリクエスト形式によって異なります
image_input · 条件付き対応 — 互換エンドポイントとリクエスト形式によって異なります
video_input · 条件付き対応 — 互換エンドポイントとリクエスト形式によって異なります

互換エイリアスと廃止済みリダイレクト

gemini-3.7-flash, gemini-3.6-flash, gemini-3.5-flash, gemini-3-flash, gemini-3-flash-preview, gemini-3.1-flash-lite, gemini-3.1-flash-lite-preview → gemini-3.8-flash (廃止済みリダイレクト)

モデル機能カタログ · 価格を確認