API429 / Google

Gemini API через API429: выбор модели и интеграция

Сравните Gemini для анализа текста, разработки и обработки записей. Здесь выбор модели связан с задачей приложения, доступом ключа и проверкой результата через API429.

Модели и текущие ставки API429

Ниже — точные текстовые ID выбранного семейства. Публичный каталог и список GET /v1/models для вашего ключа решают разные задачи: опубликованная запись не подтверждает доступ любого аккаунта. Не заменяйте дефисы, точки или версию по сходству названий.

Модель / точный IDAPI429: USD и единицы оплаты
Gemini 4 Argongemini-4-argon
$0.030000000000 / 1 000 000 кешированных входящих токенов
$0.600000000000 / 1 000 000 входящих токенов
$3.000000000000 / 1 000 000 выходящих токенов
Gemini 3.8 Flashgemini-3.8-flash
$0.225000000000 / 1 000 000 токенов записи в кеш
$0.022500000000 / 1 000 000 кешированных входящих токенов
$0.225000000000 / 1 000 000 входящих токенов
$1.125000000000 / 1 000 000 выходящих токенов
Gemini 3.5 Flash Litegemini-3.5-flash-lite
$0.0900 / 1 000 000 токенов записи в кеш
$0.0090 / 1 000 000 кешированных входящих токенов
$0.0900 / 1 000 000 входящих токенов
$0.7500 / 1 000 000 выходящих токенов
Gemini 2.5 Flashgemini-2.5-flash
$0.090000000000 / 1 000 000 токенов записи в кеш
$0.090000000000 / 1 000 000 кешированных входящих токенов
$0.090000000000 / 1 000 000 входящих токенов
$0.750000000000 / 1 000 000 выходящих токенов

Дата данных каталога: . Ставки показываются с условиями из каталога; отсутствующая строка не означает бесплатный запрос.

Пример бюджета для gemini-3.8-flash: 1 000 запросов, каждый с 2 000 обычных входных и 500 выходных токенов, — $1.012500. Это оценка обычных текстовых токенов, без кеша, инструментов, повторов и дополнительных сборов. Она не является полным счётом или подтверждением приёма запроса.

Подробные тарифы семейства и калькулятор · Полный каталог

Выберите сценарий для Gemini

Начните с одной задачи: найти противоречие в описании системы, проверить план исправления или извлечь поля из набора записей. Для этих сценариев нужны разные критерии готовности. Сформулируйте, какие сведения модель обязана сохранить и в каких случаях должна сообщить о недостатке данных. Большой документ не делает ответ автоматически полнее. Прежде чем передавать длинный материал, проверьте короткую версию задания с известным правильным результатом.

Argon, Flash и Flash-Lite: что сравнивать

В проверенных профилях Argon связан с ограниченной задачей логики и программирования, Flash — с разбором изменения в нескольких файлах, Flash-Lite — с извлечением и классификацией. Эти примеры помогают составить набор оценок, но не устанавливают превосходство модели. Для существующей нагрузки Gemini 2.5 Flash можно сохранить как исходную точку сравнения. Проверяйте сохранение фактов, полноту нужных полей и число дополнительных попыток на одном и том же материале.

Длинный вход требует плана проверки

Для анализа документа заранее определите, какие разделы действительно нужны. Пришлите явный вопрос, перечень ожидаемых выводов и требование отмечать отсутствующие сведения. Затем проверьте ответ по исходному тексту, включая фрагменты ближе к концу документа. Характеристики Google не устанавливают эффективный размер запроса API429. Если проекту нужен большой вход или длинный ответ, подтвердите ограничения по документации и поддержке до загрузки рабочей партии документов.

Подключение текстового метода

Проверьте нужный Gemini ID через GET /v1/models со своим ключом. Первый запрос отправьте на POST /v1/chat/completions с model и messages, используя короткий искусственный текст. Наличие модели в публичном каталоге не заменяет проверку доступа ключа. Обработайте ошибки HTTP, неполный ответ и неожиданный формат. Производительские настройки thinking, фонового выполнения, кеширования или мультимодального ввода не следует включать только потому, что они есть в документации прямого Gemini API.

Миграция без потери контрольной точки

Перед заменой Flash или Flash-Lite сохраните несколько типичных входов и результаты, которые приложение уже принимает. Добавьте неудобные случаи: пропущенное поле, конфликтующие утверждения и документ с нерелевантным фрагментом. Сравните обе версии по одной процедуре. Не выводите доступность API429 из правил доступа прямого Google API. Изменения нативного протокола Google и его параметры также требуют отдельной проверки, даже если отображаемые названия моделей похожи.

Стоимость и следующий шаг

Расход оценивайте по полному входу, выходу и числу повторных генераций до принятого результата. Текущие ставки API429 берите из каталога модели, не переносите условия производителя автоматически. Внешние цены и расчёты находятся в отдельном сравнении Gemini API. Региональные вопросы доступа разобраны на специальной странице, а эта страница помогает выбрать модель и начать проверку. Условия оплаты и настройки кабинета уточняйте в сервисе или поддержке перед расширением нагрузки.

Выберите следующий шаг подключения

  • Gemini API для проектов из России

    Региональные вопросы подключения, ключа и оплаты разобраны в отдельной инструкции; условия проверяются для вашего аккаунта.

  • Vertex AI и способы подключения Google

    Различия нативного метода Google и клиентского контракта API429: выберите нужную инструкцию до настройки приложения.

  • Выбор текстового Gemini Flash

    Если нужен текстовый ответ, начните с выбора Flash и проверки точного ID для ключа.

  • Подключение генерации изображений Nano Banana

    Если нужен файл изображения, перейдите к отдельному руководству по модели и методу генерации: текстовый запрос из этой страницы не проверяет создание изображения.

  • Тарифы изображений Nano Banana

    Для бюджета изображений проверьте отдельные единицы оплаты и условия; ставки обычных текстовых токенов из этой таблицы не являются ценой картинки.

Первый текстовый запрос: curl, Python, JavaScript

  1. Создайте ключ в личном кабинете API429, проверьте баланс и доступные условия оплаты.
  2. С тем же ключом проверьте точный ID gemini-3.8-flash в GET https://gateway.api429.com/v1/models.
  3. Задайте API429_API_KEY в окружении сервера и выполните небольшой запрос. Генерация платная; пример не выполняет автоматических повторов.
  4. Проверьте HTTP-статус, finish_reason, текст и фактический usage. Таймаут не доказывает, что операция не оплачена.

Пример использует только базовый текстовый контракт Chat Completions с max_tokens=512. Он не подтверждает поддержку нативных методов производителя, tools, reasoning, vision или его лимитов через API429. Python и JavaScript проверяют доступ ключа перед генерацией; для curl выполните проверку списка отдельно.

curl

curl --fail-with-body https://gateway.api429.com/v1/chat/completions \
  -H "Authorization: Bearer $API429_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"Объясни назначение HTTP 429 в одном предложении."}],"max_tokens":512,"stream":false}'

Python 3

import json
import os
import urllib.request

key = os.environ["API429_API_KEY"]
base = "https://gateway.api429.com/v1"
headers = {"Authorization": "Bearer " + key, "Content-Type": "application/json"}
models_request = urllib.request.Request(base + "/models", headers=headers)
with urllib.request.urlopen(models_request, timeout=30) as response:
    available = {item["id"] for item in json.load(response)["data"]}
model = "gemini-3.8-flash"
if model not in available:
    raise ValueError("Model is unavailable to this key")
payload = json.loads("{\"model\":\"gemini-3.8-flash\",\"messages\":[{\"role\":\"user\",\"content\":\"Объясни назначение HTTP 429 в одном предложении.\"}],\"max_tokens\":512,\"stream\":false}")
request = urllib.request.Request(base + "/chat/completions",
    data=json.dumps(payload).encode("utf-8"), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=60) as response:
    result = json.load(response)
choice = result["choices"][0]
if choice.get("finish_reason") != "stop" or not choice.get("message", {}).get("content"):
    raise ValueError("Incomplete or empty response")
print(choice["message"]["content"])
print(result.get("usage"))

JavaScript: Node.js 18+

const key = process.env.API429_API_KEY;
if (!key) throw new Error("Set API429_API_KEY");
const base = "https://gateway.api429.com/v1";
const headers = { Authorization: "Bearer " + key, "Content-Type": "application/json" };
const model = "gemini-3.8-flash";
const available = await fetch(base + "/models", { headers, signal: AbortSignal.timeout(30000) });
if (!available.ok) throw new Error("Models HTTP " + available.status);
if (!(await available.json()).data.some(item => item.id === model)) throw new Error("Model unavailable to this key");
const response = await fetch(base + "/chat/completions", {
  method: "POST", headers, signal: AbortSignal.timeout(60000),
  body: JSON.stringify({"model":"gemini-3.8-flash","messages":[{"role":"user","content":"Объясни назначение HTTP 429 в одном предложении."}],"max_tokens":512,"stream":false})
});
if (!response.ok) throw new Error("Generation HTTP " + response.status);
const result = await response.json();
const choice = result.choices?.[0];
if (choice?.finish_reason !== "stop" || !choice?.message?.content) throw new Error("Incomplete or empty response");
console.log(choice.message.content);
console.log(result.usage);

Примеры не подтверждают доступ вашего ключа; проверьте точный ID перед платным запросом. API-контракт · Настройка совместимого клиента · Вопросы и поддержка

Частые вопросы

Подходит ли любой Gemini для извлечения полей?

Это проверяется на вашей контрольной выборке. Сравните Flash-Lite и другие доступные варианты по заполненным полям, корректному обозначению неизвестных значений и количеству исправлений. Не позволяйте модели дополнять отсутствующие данные выдуманными сведениями.

Можно ли отправить изображение, раз модель Gemini?

Название семейства не подтверждает поддержку изображения конкретным методом API429. Проверьте публичные возможности, формат запроса и доступность режима отдельно. Начальный пример на этой странице относится к текстовой задаче.

Означают ли правила Google ограничения моего ключа API429?

Правила прямого сервиса Google описывают его собственный доступ. Они не устанавливают права вашего ключа API429. Нужный ID проверяется через GET /v1/models; спорные случаи уточняйте в поддержке.

Где читать про доступ к Gemini из России?

На отдельной странице о региональном доступе Gemini. Здесь собраны выбор модели и подготовка текстовой интеграции. Актуальные способы оплаты и условия аккаунта проверяйте в кабинете или уточняйте у поддержки API429.

Источники и редакционная проверка

Документация производителей объясняет семейство и правила их собственных API. Точные ID, ставки и контракт API429 проверяются по его каталогу и документации отдельно.

Проверено . Для подключения создайте аккаунт API429 и следуйте инструкции начала работы.

Telegram