Gemini 3.8 Flash через API: подключение, цены и массовые задачи

Gemini 3.8 Flash — одна из самых дешёвых моделей в каталоге Zukko, и её чаще всего берут под массовую обработку: классификацию, разметку, извлечение полей из коротких текстов. Ниже — как подключить Gemini 3.8 Flash API по ключу Zukko, что она умеет и чего нет в нашем каталоге, и сколько стоит миллион коротких запросов в сравнении с соседними моделями.

Цены Gemini 3.8 Flash в Zukko

Идентификатор модели — gemini-3.8-flash. Цены в долларах за 1 млн токенов на 6 октября 2026 года:

Индекс силы в каталоге — 41 (Intelligence Index от Artificial Analysis, сводный балл по бенчмаркам). Набор моделей и цены меняются: актуальные данные — GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете.

Подключение Gemini 3.8 Flash API

Модель вызывается через тот же OpenAI-совместимый адрес, что и остальные. Отдельный SDK от Google не нужен — подойдёт пакет openai:

from openai import OpenAI

client = OpenAI(base_url="https://api.zukko.pro/v1", api_key="fetch_ваш_ключ")

resp = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[
        {"role": "system", "content": "Определи тональность отзыва. Ответь одним словом: позитив, негатив или нейтрально."},
        {"role": "user", "content": "Доставили на день позже, но курьер вежливый, товар целый."},
    ],
    max_tokens=10,
)
print(resp.choices[0].message.content)

То же через curl:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "max_tokens": 10,
    "messages": [{"role": "user", "content": "Переведи на английский: срок поставки — 5 дней"}]
  }'

Если нужен Anthropic-формат, модель работает и через POST /v1/messages — шлюз сам конвертирует запрос.

Картинки на вход: в нашем каталоге их нет

У gemini-3.8-flash в каталоге Zukko не отмечен приём изображений — отправляйте ей только текст. Если в задаче есть сканы, скриншоты или фотографии, возьмите модель с поддержкой картинок, например:

Рабочая схема для смешанного потока: текстовые задачи — на Gemini 3.8 Flash, задачи с изображениями — на одну из моделей из таблицы. Ключ и баланс у них общие, меняется только поле model.

Расчёт: миллион коротких запросов

Возьмём типичную массовую задачу: 1 000 000 запросов, в каждом 300 токенов входа (инструкция плюс короткий текст) и 100 токенов ответа. Итого 300 млн токенов входа и 100 млн выхода.

Формула: стоимость = вход (млн) × цена входа + выход (млн) × цена выхода.

Для Gemini 3.8 Flash: 300 × 0.025 + 100 × 0.088 = 7.5 + 8.8 = $16.30.

По официальной цене вендора: 300 × 0.75 + 100 × 3.75 = 225 + 375 = $600.

Та же нагрузка на других недорогих моделях Zukko:

Что видно из таблицы: на такой нагрузке DeepSeek V4.1 Flash и Gemini 3.7 Flash дешевле Gemini 3.8 Flash, а GLM 5.3 Flash стоит почти столько же при индексе 42, но с контекстом 128K. Цифры индекса — сводный балл по чужим задачам; какая модель лучше справится с вашей разметкой, покажет только проверка. Подробное сравнение двух самых дешёвых вариантов — в статье DeepSeek или Gemini Flash↗.

Обратите внимание на структуру счёта: из $16.30 у Gemini 3.8 Flash $8.80 приходится на выход. Ограничивайте max_tokens и просите короткий формат ответа — это прямая экономия. Сверяйте completion_tokens в usage на пробной партии: если модель рассуждает перед ответом, фактический выход может оказаться больше видимого текста.

Как запускать массовую обработку

Несколько практических правил:

1. Сначала пробная партия. Прогоните 200–500 запросов, посчитайте средние prompt_tokens и completion_tokens из usage и умножьте на полный объём. Это точнее любой прикидки.
2. Отдельный ключ под задачу. В кабинете можно задать ключу дневной и месячный лимит в долларах и список разрешённых моделей — например, только gemini-3.8-flash. Ошибка в цикле не съест баланс.
3. Обработка 429. Общего ограничения частоты у Zukko нет: 429 означает исчерпанный лимит ключа (key_daily_limit_reached / key_monthly_limit_reached) — тогда повтор не поможет — или ограничение у провайдера модели. Во втором случае ограничьте параллельность и повторяйте с паузой; SDK openai сам делает несколько повторов.
4. Защита от двойной оплаты. Если пайплайн перезапускается, передавайте заголовок Idempotency-Key с уникальным значением для каждой строки: повтор успешного запроса с тем же ключом вернёт сохранённый ответ без второго списания. Подробности — в разделе о лимитах ключа и кэше↗.

Пример с ограничением параллельности:

import asyncio
from openai import AsyncOpenAI

client = AsyncOpenAI(base_url="https://api.zukko.pro/v1", api_key="fetch_ваш_ключ")
sem = asyncio.Semaphore(10)

async def classify(row_id: int, text: str) -> str:
    async with sem:
        resp = await client.chat.completions.create(
            model="gemini-3.8-flash",
            messages=[
                {"role": "system", "content": "Ответь одним словом: позитив, негатив или нейтрально."},
                {"role": "user", "content": text},
            ],

Стоимость отдельного запроса видна в заголовке X-Zukko-Cost-Micros (у не потоковых ответов), итог по дням — в разделе «Использование». Общие параметры запроса описаны в справочнике /v1/chat/completions↗.

Чтобы попробовать, создайте ключ на странице API-ключей↗ и прогоните пробную партию на своих данных.

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

Можно ли отправить Gemini 3.8 Flash картинку?

В каталоге Zukko приём изображений для этой модели не отмечен. Для задач с картинками берите модель с поддержкой изображений, например deepseek-v4-pro или gpt-6.1-sol.

Сколько стоит тысяча коротких запросов?

При 300 токенах входа и 100 выхода: 0.3 × 0.025 + 0.1 × 0.088 = 0.0075 + 0.0088 = $0.0163.

Помогает ли кэш на коротких запросах?

Чтение кэша у модели стоит $0.013 против $0.025 за вход (учитывается, если поставщик сообщает о нём в ответе; запись отдельно не списывается), но кэшируется только повторяющееся начало запроса. При 300 токенах на запрос повторять почти нечего, поэтому в расчётах выше кэш не учтён — это верхняя граница стоимости.

Как оплатить из России?

Баланс в долларах пополняется через СБП, карту РФ или криптовалюту, минимальная сумма — $1.