
Gemini 3.6 Flash 完全ガイド:API、Thinking、活用例、本番運用
Gemini 3.6 Flash早見表
| 項目 | 現在の情報 | 開発者への示唆 |
|---|---|---|
| ステータス | 2026年7月21日からGA | 管理された本番評価が可能 |
| モデルID | gemini-3.6-flash | 初期の-tiered表記は使わない |
| 入力コンテキスト | 1,048,576トークン | メディア解像度と履歴は引き続き管理 |
| 最大出力 | 65,536トークン | 必要に応じアプリ側で低い上限を設定 |
| 入力 | テキスト、画像、音声、動画、PDF | マルチモーダル理解用であり生成用ではない |
| 出力 | テキスト | 画像・音声のネイティブ生成なし |
| 既定Thinking | medium | 既定値から始め実データで変更 |
Gemini 3.6 Flashとは?誰に向くモデルか
Flashファミリーの速度とスケーラブルな推論を保ちながら、高速チャット以上の役割を担います。Googleはコーディングエージェント、複雑なツール利用、マルチモーダル文書、視覚・空間推論を重視しています。評価では、修正ターンや無関係なコード変更を減らせるか、適切なツールを選べるか、介入を減らしてタスクを完了できるかを測ります。
すべての用途に最適とは限りません。大量の分類、ルーティング、単純抽出にはFlash-Lite系、最高水準の推論にはPro系が適する場合があります。画像生成、音声出力、リアルタイム音声には専用モデルが必要です。
| ワークロード | 最初に評価する候補 | 理由 |
|---|---|---|
| コーディング、デバッグ、複数ステップのエージェント | Gemini 3.6 Flash | 推論、ツール、効率のバランス |
| 単純分類、タグ付け、ルーティング | Flash-Lite系 | 深い推論よりスループットと低コスト |
| 難しい調査・複雑な推論 | Pro系 | レイテンシより推論上限を重視 |
| 画像・音声・リアルタイム音声生成 | 専用生成・Liveモデル | 3.6 Flashの出力はテキストのみ |
主な読者はアプリ開発者、エージェントエンジニア、プラットフォームチーム、プロダクト責任者、FinOps担当者です。それぞれAPI互換性、ツールループ完了、ロールアウトとフォールバック、ユーザー受容、受理タスク当たりコストを成功指標にします。
公式機能と実務上の境界
Googleの機能一覧は上流モデルを示します。Computer UseなどのPreviewツールは、セキュリティ、権限、チャネルの個別検証が必要で、安定したテキスト生成と同列には扱えません。
| 機能 | 公式ステータス | 実務上の境界 |
|---|---|---|
| Thinking | 対応 | 品質、遅延、コストのバランスを取る |
| システム指示 | 対応 | アプリ側の認可を代替しない |
| Structured Outputs | 対応 | スキーマと業務ルールをサーバーで検証 |
| Function Calling | 対応 | ツール実行、再試行、副作用はアプリが担当 |
| Code Execution | 対応 | 本番資格情報や非隔離システムを渡さない |
| Google Search / Maps | 対応 | 権限、出典、別料金を確認 |
| Context Caching | 対応 | ヒット率と保管コストを測定 |
| URL Context | 対応 | 外部ページを信頼できない入力として扱う |
| Computer Use | Preview | 隔離し、重要操作は承認制にする |
| Live API | 非対応 | リアルタイム音声はLiveモデルを使用 |
| ファインチューニング | 非対応 | コンテキストと指示で調整 |
同じ上流モデルでもチャネルによって公開機能が異なります。モデル機能、チャネルのパススルー、Usage、課金を個別に確認してください。
リクエスト構造:よく使うフィールド
| フィールド | 必須 | 用途 | 本番上の注意 |
|---|---|---|---|
contents | はい | 複数ターンとマルチモーダル内容 | ユーザー入力で終え、最終modelターンを先書きしない |
systemInstruction | いいえ | 役割、規則、出力境界 | 秘密情報や不可逆な権限を置かない |
generationConfig | いいえ | 出力長、Thinking、構造化出力 | ワークロード別に管理 |
tools | いいえ | Function CallingとCode Execution | 引数と応答をスキーマ検証 |
safetySettings | いいえ | 安全ポリシー | 製品リスクに合わせる |
cachedContent | いいえ | キャッシュ済みコンテキスト | ヒット率と保存コストを監視 |
まずプレースホルダーのBase URLでGoogleネイティブ形式を理解します。チャネル、認証、料金は後半で比較します。
curl "{BASE_URL}/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"冪等なAPIを3点で説明してください。"}]}]}'generateContentをstreamGenerateContentに変え、Server-Sent Eventsでは?alt=sseを追加します。プロキシのバッファリング、タイムアウト、切断復旧は実環境で起きるため、同期とストリームを別々に試してください。temperature、topP、topKを調整手段として前提にしないでください。Gemini 3.xは既定のサンプリング向けに最適化され、これらが無視される場合があります。candidateCount > 1も失敗します。複数候補は独立して観測可能なリクエストにします。Thinking Level:品質、遅延、コストの調整
usageMetadata.thoughtsTokenCountに現れ、出力料金で課金されます。mediumを使用し、実タスクで推論不足が確認された場合だけhighを試します。分類、抽出、単純なツールルーティングは低いレベルを検証できます。すべてをhighにすると、初回トークンまでの時間、コスト、不要なツール操作が増える可能性があります。| タスク | 開始レベル | 測定項目 |
|---|---|---|
| 分類、ルーティング、定型抽出 | minimal | 遅延、スキーマ準拠、エラー率 |
| 文書Q&A、通常のコード説明 | medium | 正確性、引用範囲、コスト |
| デバッグ、数学、複数ツール | high | 完了率、修正ターン、ツールループ |
| ユーザー向け対話機能 | mediumから下げて検証 | P95、ユーザー受容 |
curl "{BASE_URL}/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"この並行コードの競合状態を見つけ、最小の安全な修正を提案してください。"}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":4096}}'thinkingLevelと旧thinkingBudgetを同時に送ると失敗します。移行では旧フィールドを先に削除し、見える回答長ではなく成功タスク当たりコストで比較してください。レスポンス、ストリーム、Usageで記録するもの
candidates[].content.parts、終了理由はfinishReasonにあります。usageMetadataにはpromptTokenCount、candidatesTokenCount、thoughtsTokenCount、totalTokenCountが含まれます。モデルID/バージョン、開始・終了時刻、HTTP、終了理由、入力、可視出力、thought tokens、ツール、再試行、業務上の受理を記録します。HTTP成功数ではなく、受理されたタスクを完了するコストが有用な指標です。
{
"candidates":[{"content":{"role":"model","parts":[{"text":"..."}]},"finishReason":"STOP"}],
"usageMetadata":{"promptTokenCount":1200,"candidatesTokenCount":480,"thoughtsTokenCount":320,"totalTokenCount":2000},
"modelVersion":"gemini-3.6-flash"
}この例では可視出力480とthought 320の両方が出力側の課金対象です。
マルチモーダル入力と構造化出力
partsにテキストとメディアを組み合わせられます。リモートファイルはfileData、小さなBase64はinlineDataを使います。内部URLの無制限取得を防ぐため、MIME、サイズ、権限、URL出所をサーバーで検証します。画像、グラフ、インターフェース
文書抽出、グラフ解釈、視覚QA、UI理解に使えます。対象領域、項目、出力形式を明示してください。低解像度、小さなラベル、曖昧な座標を実際の評価セットで確認します。
PDFと長文書の分析
100万トークンは契約書、レポート、技術文書、コードベースに役立ちますが、情報設計は必要です。引用を求め、セクション横断の想起と見落としを測ります。大入力は遅延とコストを増やし、解像度もトークン量を変えます。
音声・動画の理解
可能なら長いメディアを分割し、時刻情報を保持します。イベント想起、タイムスタンプ精度、映像と発話の混同を評価します。これは理解であり、ネイティブ生成ではありません。
Structured Outputの例
{
"contents":[{"role":"user","parts":[
{"text":"この請求書から取引先、日付、通貨、合計を抽出してください。"},
{"fileData":{"mimeType":"image/jpeg","fileUri":"https://example.com/invoice.jpg"}}
]}],
"generationConfig":{"responseMimeType":"application/json","responseSchema":{"type":"object","properties":{"vendor":{"type":"string"},"date":{"type":"string"},"currency":{"type":"string"},"total":{"type":"number"}},"required":["vendor","date","currency","total"]}}
}Structured Outputsはパース失敗を減らしますが、事実は保証しません。金額、日付、アカウントの範囲、形式、根拠を検証し、契約と支払いは人が確認します。
Function Calling、Code Execution、エージェント設計
信頼できるツールループは5段階です。モデルが構造化呼び出しを提案し、アプリが引数を検証・実行し、一致するFunctionResponseを返し、モデルが次の操作または最終回答を出します。呼び出しID、ツール名、引数、結果、遅延を保存します。
モデルに無制限の実行権限を与えてはいけません。ツールを副作用で分類し、読み取りは自動化可能、可逆な書き込みは冪等性とロールバック、決済・公開・削除・権限変更は明示的な人の承認を要求します。
| リスク | 制御 | 指標 |
|---|---|---|
| ループが止まらない | 最大ターン、タイムアウト、累積コスト上限 | ツール回数の平均/P95 |
| 引数の幻覚 | JSON Schema、enum、サーバー検証 | 引数拒否率 |
| 無関係なコード変更 | ファイル範囲、テスト、diffレビュー | パッチ受理率、無関係変更率 |
| 外部コンテンツの注入 | Webとファイルを未信頼データ化 | ブロック/未認可操作 |
| 重複書き込み | 冪等キー、トランザクション、状態確認 | 重複操作率 |
コーディングエージェントには実リポジトリの課題を使い、バグ修正、テスト、最小diffを求めます。初回成功、テスト通過、修正回数、無関係変更、受理パッチ当たりコストを測定します。ベンダーベンチマークは仮説にすぎません。
最初に試すべき8つの開発者ユースケース
| ユースケース | 設定 | 受け入れ指標 | 主なリスク |
|---|---|---|---|
| コーディングエージェント | mediumとhighを比較 | テスト、パッチ受理 | 無関係変更、再修正 |
| 複数ツールエージェント | ツール、ターン、総コストを制限 | 完了率、選択精度 | 重複、過剰権限 |
| 長いPDF分析 | 引用とスキーマを要求 | 引用精度、見落とし率 | 文脈コスト、誤帰属 |
| 画像・グラフ理解 | 領域、項目、形式を指定 | 項目・位置精度 | 解像度、視覚誤認 |
| 動画・音声理解 | 分割し時刻を保持 | イベント想起、時刻精度 | メディアトークン増大 |
| 構造化抽出 | スキーマとサーバー検証 | 準拠率、再試行率 | 形式は正しいが事実が誤り |
| バッチ分類・要約 | 低いThinkingから | スループット、タスク単価 | 過剰推論 |
| ユーザー向けAI | Streaming、timeout、fallback | TTFT、P95、受容 | ピーク遅延、供給元差 |
いずれも客観的に測れます。「良さそう」は合格基準ではなく、機械指標と人間の評価基準が必要です。
Gemini 3.6 Flashを使わない方がよい場合
- ネイティブの画像・音声生成が必要。
- リアルタイム音声でネイティブLive APIが必須。
- Computer Useが必須だがPreview変更や人の承認を許容できない。
- 単純・大量処理で最低単価だけが重要。
- 決済、削除、公開などに承認とロールバックがない。
- 実際の評価セットがなく公開ベンチマークだけに依存。
- 現行モデルが目標を満たし、品質・遅延・コストの改善が測定できない。
よくあるAPIエラー:症状、原因、対処
| 症状 | 原因 | 対処と確認 |
|---|---|---|
| HTTP 400 | 最終ターンをmodelで先書き | prefillを削除しユーザー入力で終了 |
| Samplingが効かない | temperature、topP、topK | 削除しThinkingと指示を使用 |
| Thinking設定エラー | thinkingLevelとthinkingBudgetが共存 | thinkingLevelだけ残す |
| 複数候補が失敗 | candidateCount > 1 | 削除または1に設定 |
| JSON解析失敗 | プロンプトでJSONとだけ指定 | responseMimeTypeとresponseSchemaを使用 |
| ツール過多 | Thinkingが高いか規則が広い | レベル、ツール、ターンを制限 |
| 予想より高額 | Thoughts、履歴、再試行の累積 | 完全なUsageと受理単価を保存 |
| ストリーム切断 | Proxy、timeout、復旧不足 | SSE、heartbeat、再接続、冪等retryを試験 |
エラー時は入力を縮小する前に、秘匿済みリクエスト、HTTP、エラー、モデル版、リクエストIDを保存します。テレメトリなしのプロンプト変更は原因特定を難しくし、課金も続きます。
公式料金と実際のタスクコスト
$1.50、出力は$7.50です。thought tokensも出力課金です。定価は有用なタスクを完了するコストそのものではありません。実タスクコスト
= 入力トークン
+ 可視出力とthought tokens
+ ツールまたはgrounding
+ キャッシュ
+ 失敗した再試行入力100,000、可視出力6,000、thought 4,000の場合:
100,000 / 1,000,000 × $1.50
+ 10,000 / 1,000,000 × $7.50
= $0.225全再試行でほぼ倍になります。受理結果当たりで比較し、誤ったツール、無関係な編集、人の修正を減らす効果も含めます。
評価から本番へ:リプレイ、カナリア、フォールバック
- 通常、境界、失敗を含む秘匿済み実タスクを抽出する。
- 現行モデルの品質、P50/P95、トークン、再試行、人の介入を記録する。
- 同じ入力をオフライン再生し、レビュー時はモデル名を隠す。
- 出力をユーザーに返さないシャドートラフィックで観察する。
- 自動停止基準付きの小さな低リスクカナリアを開く。
- 安定モデルをフォールバックに残し、timeoutとエラーを訓練する。
- 受理タスク単価、遅延、安全性が同時に合格した場合だけ拡大する。

| ゲート | 合格条件例 |
|---|---|
| 互換性 | 未知の4xxなし、構造化/ツール応答を解析可能 |
| 品質 | 重要タスクの受理率がベースライン以上 |
| 遅延 | P95が予算内、切断ストリームを復旧可能 |
| コスト | 受理タスク当たりの目標を達成 |
| 安全性 | 未認可ツールなし、重要操作は承認済み |
| ロールバック | アプリリリース不要でfallback可能 |
Googleへ直接接続するか、AI APIアグリゲーターか
モデル評価後は、統合・運用の複雑さを誰が持つかを決めます。Geminiのみを使うか、認証、リクエスト差分、Usage、請求、移行をチームが長期保守するかによって、どちらも正解になり得ます。
Google直接接続が向く場合
- 製品がGeminiだけを使う予定。
- 権限、請求、監視がGoogle Cloudに統合済み。
- GoogleのPreview機能へ最速でアクセスしたい。
- クォータ、エラー、コスト分析、災害復旧を自社で運用できる。
- ネイティブインターフェースへの密結合を許容できる。
AI APIアグリゲーターが向く場合
- タスクごとに異なるモデルを選ぶ。
- 同一評価セットで品質、遅延、コストを比較したい。
- プロバイダーごとのアカウント、キー、請求を避けたい。
- モデル、価格、可用性の変化に切り替え余地が必要。
- 新モデルで既存統合、テレメトリ、ロールアウトを再利用したい。
| 判断領域 | 直接接続 | AI APIアグリゲーター |
|---|---|---|
| 新モデル | 個別に構築、検証、公開 | 既存入口と評価フローを再利用 |
| APIキー | プロバイダーごと | 1つの基盤で集中管理 |
| Usage/請求 | 複数コンソールを照合 | 呼び出しと支出を一元観測 |
| モデル比較 | 共通アダプターを構築 | マルチモデル試験を維持しやすい |
| 移行コスト | 業務コードが供給元に依存 | 接続層の変更を削減 |
| 新上流機能 | 通常は最初に利用可能 | パススルー検証を待つ |
モデル数だけで選ばず、実際の呼び出し、明確なID/endpoint、安定したstreaming、thought Usage、追跡可能なエラー、透明な料金、非対応機能の明示を確認します。
EvoLink経由でGemini 3.6 Flashを利用する方法
EvoLinkはGoogleネイティブAPI形式で提供します。既存のGeminiリクエスト形式なら、Base URLを変更しBearer認証を使って開始できます。
| 設定 | 値 |
|---|---|
| モデルID | gemini-3.6-flash |
| 推奨Base URL | https://direct.evolink.ai |
| 予備Base URL | https://api.evolink.ai |
| 認証 | Authorization: Bearer YOUR_API_KEY |
| 同期endpoint | /v1beta/models/gemini-3.6-flash:generateContent |
| streaming endpoint | /v1beta/models/gemini-3.6-flash:streamGenerateContent |
curl "https://direct.evolink.ai/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"冪等なAPIを3点で説明してください。"}]}]}'現在のEvoLink機能境界
| 機能 | 現在のルート | 推奨事項 |
|---|---|---|
| Thinking | 対応 | thinkingConfig.thinkingLevelを使用 |
| Structured Outputs | 対応 | サーバーでスキーマを検証 |
| Function Calling | 対応 | ID、引数、結果を保存 |
| Code Execution | 対応 | 隔離環境と限定権限を使用 |
| Context Caching | 対応 | ヒット率と保存コストを監視 |
| Search / Maps / URL Context | 対応と文書化 | 本番前に権限、結果、請求を試験 |
| Computer Use | 現在非対応 | Google Previewが通ると仮定しない |
| Live API | 非対応 | リアルタイム音声は別ルートを選択 |
EvoLink料金:Google Standardより10%低い
| 項目 | Google Standard | EvoLink | 100万トークン当たりの差 |
|---|---|---|---|
| 入力 | $1.50 | $1.35 | $0.15 |
| 出力とThinking | $7.50 | $6.75 | $0.75 |
$0.2025です。割引は定価を下げますが、実運用ではUsage、再試行、タスク受理も含めます。セキュリティ、データ、コンプライアンスの確認
APIキーはサーバー側に置き、アップロードデータを分類・最小化し、Web、ファイル、ツールの内容を未信頼入力として扱います。外部内容が認可ルールを上書きしてはいけません。
ツールを読み取り、可逆な書き込み、高リスクに分類します。高リスク操作は明示的承認と監査証跡が必要です。データ利用方針も異なり、Googleの料金ページでは無料枠の内容は製品改善に使われる場合があり、有料枠は使われないとされています。契約、地域、業界要件を確認してください。
よくある質問
Gemini 3.6 Flashは正式にリリースされていますか?
EvoLinkで利用できますか?
gemini-3.6-flashをGoogleネイティブ形式で提供します。推奨はhttps://direct.evolink.ai、予備はhttps://api.evolink.aiです。どのモデルIDを使いますか?
gemini-3.6-flashです。リリース前のgemini-3.6-flash-tieredは使いません。対応する入出力モダリティは?
入力はテキスト、画像、音声、動画、PDF、出力はテキストです。画像・音声生成やLive APIのモデルではありません。
コンテキストと最大出力は?
入力1,048,576、最大出力65,536トークンです。大きな上限があっても、解像度と履歴は品質、遅延、コストに影響します。
どのThinking Levelを使うべきですか?
mediumから始め、分類・抽出はminimal、難しいコード、数学、複数ツールはhighを試します。完了率、遅延、thoughtコストで決めます。thought tokensは課金されますか?
usageMetadata.thoughtsTokenCountで確認できます。temperature、topP、topKが効かないのはなぜ?
Gemini 3.xはそれらによる調整を前提にせず、現在のルートでは無視されます。明確な指示、スキーマ、Thinking Levelを使います。
candidateCountが失敗するのはなぜ?
1回のリクエストで複数候補を返せません。1を超える値は失敗するため、独立したリクエストを送ります。
EvoLinkでの料金はいくらですか?
$1.35、出力は$6.75でGoogle Standardの90%です。Thoughtsは出力扱いで、ツールや再試行も最終コストに影響します。EvoLinkルートはComputer Useに対応しますか?
いいえ。GoogleではPreviewですが、現在のEvoLinkネイティブルートでは非対応です。
Gemini 3.5 Flashをすぐ置き換えるべきですか?
いいえ。実タスクのリプレイ、シャドートラフィック、制御されたカナリア、検証済みフォールバックを行い、コスト、遅延、品質が同時に合格してから拡大します。
出典と更新方針
機能、料金、ルート、パラメータは変わり得ます。本番前にendpoint、Usage、請求、streaming、エラー処理を自身のリクエストで確認してください。


