Skip to main content
POST
Text generation: Gemini 3.6 Flash (native Gemini format)
Используйте песочницу справа: поместите sk-your-api-key (ваш токен APIYI — ключ Google не нужен) в x-goog-api-key. В примере по умолчанию рассуждение установлено на low; нажмите «Отправить», чтобы увидеть ответ.
По умолчанию рассуждение включено. Для вызовов, чувствительных к стоимости, передавайте thinkingConfig: {"thinkingLevel": "minimal"} или {"thinkingBudget": 0}. Инструменты Search grounding, выполнения кода, контекста URL и Maps работают только на этом нативном эндпоинте. Возможности, тарификация и измеренные уровни рассуждения: Обзор Gemini 3.6 Flash.
  • Для потоковой передачи измените URL на :streamGenerateContent?alt=sse (в песочнице показан режим без потоковой передачи)
  • Выполнение кода работает, но поля executableCode / codeExecutionResult пока не возвращаются — результаты появляются в тексте ответа
  • :countTokens и явный API кэша (cachedContents) пока не включены на платформе

Краткая справка по параметрам

Примечания к ответу

  • Расход thinking указан в usageMetadata.thoughtsTokenCount (тарифицируется как output)
  • Источники grounding отображаются в 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