Skip to main content
POST
Text generation: Gemini 3.6 Flash (native Gemini format)
右側のプレイグラウンドを使ってください: sk-your-api-key(APIYI token です。Google キーは不要です)を x-goog-api-key に設定します。デフォルトの例では thinking が low に設定されています。send を押すと応答が表示されます。
Thinking はデフォルトで有効です。 コストを重視する呼び出しでは、thinkingConfig: {"thinkingLevel": "minimal"} または {"thinkingBudget": 0} を渡してください。Search grounding、コード実行、URL コンテキスト、Maps ツールは、このネイティブ エンドポイントでのみ動作します。機能、料金、測定済みの thinking レベル: Gemini 3.6 Flash の概要.
  • ストリーミングを行う場合は URL を :streamGenerateContent?alt=sse に変更してください(プレイグラウンドでは非ストリーミングを示しています)
  • コード実行は動作しますが、executableCode / codeExecutionResult フィールドは現在エコーされません — 結果はテキスト本文に表示されます
  • :countTokens と明示的な cache API(cachedContents)は、まだプラットフォームで有効になっていません

パラメータ早見表

Response notes

  • 思考コストは usageMetadata.thoughtsTokenCount に表示されます(出力として請求されます)
  • グラウンディングソースは candidates[0].groundingMetadata に表示されます; URL コンテキストは urlContextMetadata に表示されます
  • 暗黙のキャッシュヒットは usageMetadata.cachedContentTokenCount に表示されます(確率的なもので、頼りにしないでください)

承認

x-goog-api-key
string
header
必須

APIYI token, the sk- prefixed key

ボディ

application/json
contents
object[]
必須

Conversation contents; parts can mix modalities

systemInstruction
object

System instruction

generationConfig
object

Generation config

tools
object[]

Tools: google_search / url_context / codeExecution / functionDeclarations, etc.

レスポンス

Success

candidates
object[]
usageMetadata
object

Usage; thoughtsTokenCount is the thinking spend

modelVersion
string