Skip to main content
POST
Text generation: Gemini 3.6 Flash (native Gemini format)
오른쪽의 플레이그라운드를 사용하십시오: sk-your-api-key (귀하의 APIYI token — Google Key는 필요 없습니다)을 x-goog-api-key에 넣으십시오. 기본 예제는 추론을 low로 설정합니다. 보내기를 눌러 응답을 확인하십시오.
추론은 기본적으로 켜져 있습니다. 비용에 민감한 호출의 경우 thinkingConfig: {"thinkingLevel": "minimal"} 또는 {"thinkingBudget": 0}를 전달하십시오. 검색 그라운딩, 코드 실행, URL 컨텍스트, 그리고 Maps 도구는 이 네이티브 엔드포인트에서만 동작합니다. 기능, 요금, 그리고 측정된 추론 단계: Gemini 3.6 Flash 개요.
  • 스트리밍하려면 URL을 :streamGenerateContent?alt=sse로 변경하십시오(플레이그라운드는 스트리밍이 아님을 보여줍니다)
  • 코드 실행은 동작하지만, executableCode / codeExecutionResult 필드는 현재 에코되지 않습니다 — 결과는 텍스트 본문에 표시됩니다
  • :countTokens과 명시적 캐시 API(cachedContents)는 아직 플랫폼에서 활성화되어 있지 않습니다

매개변수 빠른 참조

응답 참고사항

  • 추론 사용량은 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