Gemini 3.6 Flash API の使い方

GoogleのGemini APIを通じて、モデルID gemini-3.6-flash を使用してGemini 3.6 Flashを呼び出します。これがその核となる部分です。Googleは2026年7月21日にFlashの刷新版をリリースしました。そして、3.6 Flashは主力となる階層です。これは3.5 Flashよりも出力が安価で、1Mトークンのコンテキストウィンドウを持ち、テキスト、画像、動画、音声、PDFを入力として受け入れます。このガイドでは、ゼロからテスト済みのリクエストを行うまでの手順を説明します。キーを取得し、curlとPythonで最初の呼び出しを行い、重要なパラメータを学び、デプロイ後も呼び出しが機能し続けるように回帰テストを設定します。

ボタン

始める前に必要なもの

3つのものがあり、始めるのに費用はかかりません。

Googleアカウント。キーを取得するためにサインインします。
Gemini APIキー。Google AI Studioから無料で入手でき、次のセクションで説明します。
HTTPリクエストを送信する方法。curlはどのターミナルからでも動作します。コードを書きたい場合はPythonが使えます。全体をUIで管理したい場合は、ApidogのようなAPIクライアントも利用できます。これら3つすべてを紹介します。

事前の課金設定は不要です。無料枠はAI Studioを通じて提供され、レート制限があるため、カード情報を登録せずにテストできます。これらの制限については以下で詳しく説明します。

Gemini APIキーの取得

Google AI Studioにアクセスし、Googleアカウントでサインインします。「APIキーを取得」をクリックし、次に「APIキーを作成」をクリックします。発行された文字列をコピーして安全な場所に保管してください。これはパスワードのように扱ってください。キーを持っている人は誰でもあなたのアカウントに対して費用を発生させることができます。

キーをクライアントサイドのコードに貼り付けたり、リポジトリにコミットしたりしないでください。代わりに環境変数として設定します。

export GEMINI_API_KEY="your_key_here"

公式のPython SDKは、この変数を自動的に読み取るため、秘密情報がソースファイルに含まれることはありません。正式な設定手順については、GoogleのGemini APIドキュメントを参照してください。

最初のAPI呼び出しを行う

RESTエンドポイントは、モデルの generateContent メソッドへのPOSTリクエストです。curlでの例はこちらです。

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {"text": "Explain how APIs work"}
        ]
      }
    ]
  }'

キーは x-goog-api-key ヘッダーに設定します。ボディは contents 配列で、各エントリには parts 配列があり、ここでの各パートは text 文字列です。このネストは単一のプロンプトでは煩雑に見えますが、後でテキストと画像やファイルを1つのリクエストで混在させることができるのと同じ形式です。

Pythonがお好みですか？ pip install google-genai でSDKをインストールし、次に以下のコードを実行します。

from google import genai

client = genai.Client()  # reads GEMINI_API_KEY from the environment
resp = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Explain how APIs work",
)
print(resp.text)

クライアントは GEMINI_API_KEY を自動的に取得するため、コード内にキーを記述する必要はありません。 resp.text には生成された回答が格納されます。これは5行で完結する動作する呼び出しです。

内部的には、APIはJSONを返します。生成されたテキストは candidates[0].content.parts[0].text にあります。これは、この呼び出しをガイドの後半でテストに変える際にアサートする正確なフィールドであるため、今注目しておく価値があります。

知っておくべき主要なパラメータ

基本的なリクエストは動作しますが、いくつかの設定によって返される内容が変わります。

システム命令。 ユーザープロンプトとは別に、会話全体に適用されるペルソナや一連のルールを設定します。「JSON形式でのみ回答してください」や「あなたは簡潔なコードレビュー担当者です」といった指示に使用します。これは、すべてのメッセージに指示を詰め込むよりも、トーンと形式をはるかに確実に制御できます。
最大出力トークン。 応答の長さを制限します。3.6 Flashは最大64kの出力トークンを生成できるため、長い生成の場合は上限を上げ、コストとレイテンシーを制御したい場合は下げてください。
マルチモーダル入力。 このモデルは、同じ呼び出しでテキスト、画像、動画、音声、PDFを読み取ることができます。これらはテキストとともに parts 配列に追加エントリとして追加します。出力はテキストのみなので、多種多様な入力から言葉を出力すると考えてください。コンテキストウィンドウは最大1M入力トークンを保持でき、これは長いPDFや完全な動画のトランスクリプトに対応できる容量です。
思考と推論。 3.6 Flashは、難しいプロンプトに対して回答する前に推論を行います。これが多段階の作業を改善する要因であり、出力価格に思考トークンが含まれる理由です（これについては次のセクションで詳しく説明します）。深さを速度と引き換えにしたい場合は、推論の労力を調整できます。

パラメータの全リストはGemini APIドキュメントに記載されています。フィールド名を推測するのではなく、ドキュメントが真の情報源であり、APIが更新されるとドキュメントも更新されます。

料金と無料枠

Gemini 3.6 Flashの料金は、入力トークン1Mあたり1.50ドル、出力トークン1Mあたり7.50ドルです。この出力料金は、3.5 Flashの9.00ドルから値下げされており、3.6 Flashは同じタスクで約17%少ない出力トークンを生成する傾向があるため、コスト削減効果が大きくなります。心に留めておくべき点の1つは、出力価格には思考トークンが含まれることです。モデルの内部的な推論は出力レートで課金されるため、大量の推論をトリガーするプロンプトは、目に見える回答の長さが示唆するよりもコストがかかる場合があります。その分の予算を確保してください。Gemini 3.6 Flashの料金ガイドで、詳細な計算を説明しています。

無料枠はAI Studioを通じて提供され、実際に利用できますが、レート制限があります。1分あたりのリクエスト数と1日あたりのリクエスト数に上限があり、Googleは無料枠のデータを使用して製品を改善する可能性があります。これはプロトタイピング向けに設計されており、本番環境のトラフィックには向きません。学習やテストには十分です。どの程度使えるかについては、Gemini 3.6 Flashを無料で利用する方法をご覧ください。無料枠を超えて利用する場合は、課金を有効にするだけで、同じキーが引き続き機能し、コードの変更は不要です。

ApidogでGemini APIをテストおよびデバッグする

curlは呼び出しが一度だけ動作することを示しますが、Googleが応答フィールドを変更したとき、キーの有効期限が切れたとき、またはデプロイによってリクエストが密かに壊れたときには教えてくれません。そのためには、保存され、繰り返し実行できるテストが必要です。ここにApidogがワークフローにその地位を確立する理由があります。

ApidogはAPIクライアントであり、テストプラットフォームです。Gemini呼び出しの最初から最後までの流れは次のとおりです。

リクエストを作成します。 URL https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent を使用して新しいPOSTリクエストを追加します。以前のJSONボディをリクエストボディに貼り付けます。
キーを環境変数に保存します。 Apidog環境に GEMINI_API_KEY という名前の変数を追加し、x-goog-api-key ヘッダーで {{GEMINI_API_KEY}} として参照します。秘密情報は共有リクエストから除外され、呼び出し自体を変更することなく、環境ごと（開発、ステージング、本番）にキーを切り替えることができます。
アサーションを追加します。 リクエストが実行された後、JSON応答に対してアサートします。ステータスが200であり、candidates[0].content.parts[0].text が存在し、空でないことを確認します。これにより、成功した実行は、単に何かが返されただけでなく、APIが実際に応答したことを意味します。
保存してスケジュール設定します。 リクエストをコレクションに保存し、回帰テストとしてスケジュール設定します。タイマーまたはCI内で実行することで、Gemini呼び出しが機能しなくなった瞬間を、ユーザーよりも早く知ることができます。

Apidogをダウンロードすれば、このテストを数分で実行できます。これはまさに正直な使い方です。Apidogはモデルを実行するのではなく、あなたのアプリが依存するAPIが期待通りに応答し続けることを保証します。

よくあるエラーと解決策

初期段階で遭遇するであろうほとんどのエラーは、次の3つの失敗に集約されます。

401 Unauthorized (無効なキー)。 キーが間違っている、取り消されている、またはヘッダーから欠落しています。x-goog-api-key にAI Studioからの正確な文字列が設定されているか、環境変数が実際に解決されているかを確認してください。末尾のスペースや展開されていない {{GEMINI_API_KEY}} がよくある原因です。
429 Too Many Requests (レート制限)。 無料枠の1分あたりまたは1日あたりの上限に達しました。リクエストレートを遅くするか、バックオフ付きのリトライを追加するか、課金を有効にして上限を引き上げてください。厳密なテストループではすぐにこれが発生します。
404 Not Found (モデルが見つかりません)。 これはほとんどの場合、モデルIDの入力ミスです。正確には gemini-3.6-flash です。gemini-3.5-flash でも gemini-flash-3.6 でもありません。同じリリースに含まれるLiteティアは gemini-3.5-flash-lite であり、3.5系統の異なるモデルなので、混同しないようにしてください。

よくある質問

Gemini 3.6 Flashの正確なモデルIDは何ですか？ gemini-3.6-flash です。SDKではモデル名として、REST URLパスでは :generateContent の直前に使用します。
Gemini 3.6 Flash APIは無料で利用できますか？ AI Studioを通じて無料枠があり、レート制限があります。プロトタイピングや学習には十分です。本番環境のトラフィックには課金を有効にする必要があります。詳細については、無料で利用する方法をご覧ください。
モデルに何を送信できますか？ テキスト、画像、動画、音声、PDFを、最大1Mトークンのコンテキストウィンドウで送信できます。出力はテキストのみです。
請求額が目に見える応答よりも高かったのはなぜですか？ 1Mトークンあたり7.50ドルの出力価格には、モデルの思考トークンが含まれています。推論負荷の高いプロンプトは、画面に表示される回答の長さよりも多く課金されます。
これは古いGemini 3.5 Flash APIと同じですか？ 呼び出しの形式は同じです。したがって、Gemini 3.5 APIを使用していた場合、モデルIDを交換するだけで完了です。3.6 Flashは出力価格を削減し、同じ作業でより少ない出力トークンを使用します。
curl、Python、Apidogで同じキーを使用できますか？ はい、できます。AI Studioから取得した1つのキーは、これらすべてで機能します。ハードコーディングするのではなく、各ツールで環境変数として保持することで、一箇所でキーをローテーションまたは取り消すことができます。

次のステップ

あなたはキー、curlとPythonでの動作する呼び出し、重要なパラメータ、そしてエンドポイントを監視する保存済みの回帰テストを手に入れました。無料枠から始め、キーを環境変数に保持し、基本的なこと以上のことについては公式ドキュメントを頼りにしてください。その呼び出しがアプリの依存関係になったら、Apidogテストで囲むことで、APIのサイレントな変更がユーザーに先に届くことがなくなります。

ボタン