Gemini API

Gemini 4 Argon и Gemini 3.8 Flash через Messages, Chat Completions и Responses: окно, цены с датами, размышления, поиск, подключение и серверный промпт.

Gemini работает с тем же ключом gd-… и общим балансом Guard. Для генерации доступны два точных ID: gemini-4-argon и gemini-3.8-flash. Короткое имя gemini ведёт на Gemini 4 Argon, новейшую модель. Других публичных ID Gemini нет.

Получите ключ в @guardapi, затем выберите HTTP, Python SDK или Node.js SDK. Покупка даёт один общий ключ; отдельная регистрация у Google не нужна.

Быстрый старт

Сохраните ключ в переменной GUARD_API_KEY; не вставляйте его в репозиторий и не печатайте в журнал.
Выберите API: Messages, Chat Completions или Responses. Программам с OpenAI-совместимым API нужен адрес https://api.guardrelay.ai/v1, клиентам Anthropic — https://api.guardrelay.ai.
Передайте точный model (gemini-4-argon) и бюджет ответа. Для первого запроса используйте обычный JSON-ответ.
Проверьте текст, конечное состояние и usage; затем при необходимости включите stream: true.

bash

export GUARD_API_KEY="gd-ваш-ключ"
curl https://api.guardrelay.ai/v1/chat/completions \
  -H "Authorization: Bearer $GUARD_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"gemini-4-argon","messages":[{"role":"user","content":"Reply with OK"}],"max_tokens":4096}'

powershell

$env:GUARD_API_KEY = "gd-ваш-ключ"
$headers = @{ Authorization = "Bearer $env:GUARD_API_KEY" }
$body = @{
  model = "gemini-4-argon"
  max_tokens = 4096
  messages = @(@{ role = "user"; content = "Reply with OK" })
} | ConvertTo-Json -Depth 10
Invoke-RestMethod -Method Post `
  -Uri "https://api.guardrelay.ai/v1/chat/completions" `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body

Один адрес, три API

API	Путь	Бюджет ответа
Messages	`POST /v1/messages`	`max_tokens`, обязателен
Chat Completions	`POST /v1/chat/completions`	`max_tokens` / `max_completion_tokens`; без явного значения — 4096
Responses	`POST /v1/responses`	`max_output_tokens`; без явного значения — 4096

Максимум ответа в обычном (синхронном) запросе — 65 536 токенов у обеих моделей. Значение 4096 по умолчанию задаёт шлюз Guard, а не модель.

Семейство выбирается точным model на общем адресе. Клиентам Anthropic нужен адрес https://api.guardrelay.ai (клиент сам добавляет /v1/messages), OpenAI-совместимым — https://api.guardrelay.ai/v1.

Messages:

bash

curl https://api.guardrelay.ai/v1/messages \
  -H "Authorization: Bearer $GUARD_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"gemini-4-argon","max_tokens":4096,"messages":[{"role":"user","content":"Reply with OK"}]}'

Responses:

bash

curl https://api.guardrelay.ai/v1/responses \
  -H "Authorization: Bearer $GUARD_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"gemini-4-argon","input":"Reply with OK","max_output_tokens":4096}'

Chat Completions показан выше, в быстром старте.

Модели и вход

Model ID	Название	Окно	Предел ответа	Размышления	Вход
`gemini-4-argon`	Gemini 4 Argon	1 048 576, общее на вход и ответ	до 65 536	Low, Medium, High	Текст, изображения, PDF
`gemini-3.8-flash`	Gemini 3.8 Flash	вход до 1 048 576	до 65 536	Low, Medium, High	Текст, изображения, PDF

Изображения и PDF принимаются встроенными данными base64 или ссылкой https. Как их передать, показано на страницах Vision и PDF / documents.

Цена

Модель	Период	Обычный ввод / 1M	Чтение кэша / 1M	Вывод / 1M
`gemini-4-argon`	до 03:00 МСК 1 декабря 2026	$2.00	$0.10	$10.00
`gemini-4-argon`	с 03:00 МСК 1 декабря 2026	$4.00	$0.20	$20.00
`gemini-3.8-flash`	до 03:00 МСК 1 января 2027	$0.75	$0.075	$3.75
`gemini-3.8-flash`	с 03:00 МСК 1 января 2027	$1.50	$0.15	$7.50

Ставки указаны в USD за 1M токенов и равны ставкам Gemini API. Google меняет их по датам: с указанной даты действуют новые ставки.

Кэш Gemini только автоматический: его ведёт Google. Маркеры cache_control принимаются, но срок хранения кэша не обещается. Скидка действует только на токены, которые Google фактически прочитал из кэша: чтение оплачивается по ставке из таблицы. За запись в кэш отдельной платы нет.

Пример для gemini-4-argon по ставкам до 03:00 МСК 1 декабря 2026: 4000 обычных входных + 8000 кэшированных + 1000 выходных токенов стоят 4000×2.00/1M + 8000×0.10/1M + 1000×10.00/1M = $0.01880000. С 03:00 МСК 1 декабря 2026 те же токены стоят $0.03760000.

Поиск в сети оплачивается отдельно: $0.014 за каждый поисковый запрос Gemini, начиная с первого. Найденный текст оплачивается как обычные входные токены. Подробности ниже, в разделе про поиск.

Размышления

Размышления Gemini полностью выключить нельзя. Уровень задаётся полем выбранного API.

API	Поле уровня	Дополнительно
Chat Completions	`reasoning_effort`	других полей нет
Responses	`reasoning.effort`	с `reasoning.summary: "auto"` модель отдаёт краткое изложение размышлений
Messages	`output_config.effort`	поле `thinking` допускает `{"type": "adaptive"}` с необязательным `display` или `{"type": "enabled"}` без других полей, в том числе без `budget_tokens`; `display: "omitted"` вместе с `adaptive` прячет текст размышлений

Модель	Значения уровня	По умолчанию
`gemini-4-argon`	`low`, `medium`, `high`	`high`
`gemini-3.8-flash`	`low`, `medium`, `high`	`medium`

Другое значение уровня получает ошибку 400 с кодом invalid_request (в Chat Completions и Responses — param: "reasoning_effort"); Guard не подменяет его другим. Остальные настройки, которых у модели нет (например, выключение размышлений), тоже получают понятную ошибку, а не подмену.

Поиск

Gemini ищет в сети поиском Google. Поиск работает на всех трёх API и включается объектом в tools; оплачивается он отдельно, по числу поисковых запросов.

API	Объект в `tools`
Messages	`{"type": "web_search_20250305", "name": "web_search"}`
Chat Completions	`{"type": "web_search"}`
Responses	`{"type": "web_search"}`

json

{
  "model": "gemini-4-argon",
  "max_tokens": 4096,
  "messages": [{"role": "user", "content": "What is new today?"}],
  "tools": [{"type": "web_search_20250305", "name": "web_search"}]
}

Что	Списание
Поисковый запрос	$0.014 за каждый запрос, начиная с первого
Перед ответом	удерживается стоимость одного поиска ($0.014); итог считается по фактическому числу поисков
Найденный текст	обычные входные токены

Инструмент web_search_20250305 присылает и Claude Code: поиск из Claude Code работает.
Отдельного инструмента web_fetch у Gemini пока нет: запрос с ним получает понятный отказ, а поиск Google работает.
Предел числа поисков max_uses принимается, но не соблюдается: сколько искать, решает Google. Каждый поиск оплачивается по цене, указанной выше.
Списки сайтов (allowed_domains, blocked_domains) не поддерживаются: запрос с ними получает понятный отказ.

Подсчёт токенов

POST /v1/messages/count_tokens работает для Gemini бесплатно. Подсчёт перед ответом возвращает приблизительную оценку всего входа (системные инструкции, инструменты и серверный промпт, если он применяется), а не точный счёт Google. Это справочное число: списание идёт по фактическому расходу, а не по оценке.

Серверный промпт

Серверный промпт Gemini настраивается так же, как у других семейств: у ключа должно быть действующее право на семейство Gemini и включена опция применения. Если условий нет, запрос идёт без промпта. Подробности — на странице Серверные промпты.

Ошибки и границы

Формат ошибок, коды и request_id общие для всех семейств: см. Коды ошибок.
Понятный отказ получают, в том числе: видео и аудио; изображение или PDF по адресу не https; уровень размышлений, которого у модели нет (invalid_request), и выключение размышлений; бюджет размышлений budget_tokens; списки сайтов в поиске; отдельный инструмент web_fetch.

Что читать дальше

MessagesТело, usage, stop_reason, tools и SSE.Chat CompletionsOpenAI-совместимый запрос и ответ.ResponsesЗапрос Responses и итоговые счётчики.Серверные промптыПраво, опция и пометка UNLOCK.Python SDKПримеры для anthropic и openai.Node.js SDKПримеры для двух SDK.

Gemini API

Быстрый старт

Один адрес, три API

Модели и вход

Цена

Размышления

Поиск

Подсчёт токенов

Серверный промпт

Ошибки и границы

Что читать дальше

Разделы

На этой странице