Skip to main content
POST
文本生成:Gemini 3.6 Flash(Gemini 原生格式)
右側 Playground 可直接除錯:在 x-goog-api-keysk-your-api-key(API易令牌,無需 Google Key),預設示例已把思考調至 low,點擊發送即可看到響應。
模型預設開啟深度思考,成本敏感場景傳 thinkingConfig: {"thinkingLevel": "minimal"}{"thinkingBudget": 0}。搜尋 grounding、程式碼執行、URL context、Maps 等工具僅本原生端點支援。模型能力、定價、思考檔位實測詳見 Gemini 3.6 Flash 概覽
  • 流式請求把 URL 改為 :streamGenerateContent?alt=sse(Playground 演示非流式)
  • 程式碼執行工具實測可用,但 executableCode / codeExecutionResult 欄位暫不回顯,結果在正文中呈現
  • :countTokens 與顯式快取 cachedContents 平臺暫未開通

引數說明速查

響應要點

  • 思考消耗看 usageMetadata.thoughtsTokenCount(計入輸出計費)
  • grounding 工具命中時 candidates[0].groundingMetadata 返回來源;URL context 看 urlContextMetadata
  • 隱式快取命中看 usageMetadata.cachedContentTokenCount(機率命中,勿依賴)

授權

x-goog-api-key
string
header
必填

API易令牌,直接填 sk- 开头的 Key

主體

application/json
contents
object[]
必填

对话内容数组,多模态 part 混排

systemInstruction
object

系统指令

generationConfig
object

生成配置

tools
object[]

工具:google_search / url_context / codeExecution / functionDeclarations 等

回應

生成成功

candidates
object[]
usageMetadata
object

用量统计,thoughtsTokenCount 为思考消耗

modelVersion
string