Gemini API поддерживает текст, изображения, аудио и видео, а цены часто выглядят привлекательно. Но доступ к сервисам Google из Китая, квоты и способы оплаты остаются типичными барьерами.

Релей для Gemini API сводит доступ и биллинг в один шлюз. Ниже — как выбрать, подключить и протестировать такое решение.

Примечание: Gemini и Google — товарные знаки соответствующих правообладателей. Материал носит технический характер; цены и интерфейсы смотрите у провайдера и на странице тарифов.

1. Что такое релей для Gemini API

Ваше приложение → шлюз → Google Gemini

Вы по-прежнему вызываете модели Gemini, но меняете Base URL и ключ на адрес шлюза. Шлюз отвечает за аутентификацию, биллинг, журналы и переключение каналов.

2. Кому подходит

  • Тем, у кого нестабильный доступ к Google из Китая.
  • Проектам с мультимодальными задачами (изображения, видео, аудио).
  • Командам, которым нужны единый счёт, участники и лимиты.
  • Тем, кто одновременно использует Gemini, Claude, GPT и DeepSeek.
  • Тем, кто часто переключает модели для A/B-тестов.

Мультимодальность — главный аргумент в пользу Gemini, но именно она чаще всего ломается при смене шлюза: форматы полей, ограничения по размеру файла и поддержка видео различаются. Заранее составьте набор тестовых файлов — небольшое изображение, длинная картинка, короткое аудио — и проверяйте их при каждом обновлении канала.

3. Критерии выбора

Критерий Что уточнить
Покрытие моделей Полнота версий Pro, Flash и других
Мультимодальность Поддержка изображений, видео и аудио на входе
Протокол Полнота совместимости с OpenAI; потоковый вывод и вызов инструментов
Стабильность Доля ошибок, P95, ограничения частоты
Биллинг Как считаются вход, выход и мультимодальные данные
Лимиты Ограничения для ключей, участников и проектов
Комплаенс Хранение данных, договор, счета

Отдельно уточните, как шлюз тарифицирует изображения и видео: по числу токенов, по длительности или по размеру файла. Это влияет на бюджет сильнее, чем цена текстовых токенов.

4. Подключение

Base URL:

https://ai.zhongshangqihang.com/v1

curl:

export GEMINI_API_KEY="sk-ваш-ключ"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [{"role": "user", "content": "Ответьте только OK"}]
  }'

Имена моделей — на странице тарифов.

Такой шлюз не заменяет SDK Google и не добавляет новых возможностей модели. Его задача — сделать доступ предсказуемым: один адрес, один ключ, понятный счёт и журнал запросов. Отдельно уточните, поддерживает ли шлюз нативный протокол Gemini или только OpenAI-совместимый режим: от этого зависит перенос существующего кода.

5. Как работать с мультимодальностью

Разные шлюзы поддерживают мультимодальные запросы по-разному. Чаще встречаются два варианта:

  1. Передача по URL: ссылка на изображение или видео внутри messages.
  2. Передача в Base64: файл кодируется и помещается в запрос.

До использования уточните поддерживаемые поля и ограничения по размеру — не копируйте формат SDK провайдера без проверки. Сначала протестируйте на небольшом изображении, затем выводите в продакшен.

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

6. Чек-лист тестов

  1. Текстовый запрос.
  2. Потоковый вывод.
  3. Входное изображение.
  4. Длинный контекст.
  5. 5 и 10 параллельных запросов.
  6. Обработка 429 и 5xx.
  7. Сверка счёта.

Квоты стоит проверять не только по документации, но и практически: отправьте серию запросов в пиковое время и посмотрите, как шлюз обрабатывает 429 — возвращает ли он задержку, повторяет ли запрос автоматически и не удваивает ли счёт. Повторите тест после изменения модели или канала: даже небольшое обновление upstream иногда меняет формат ответа.

7. Частые проблемы

Симптом Причина Что делать
Тайм-аут соединения Нет доступа к Google Использовать доступный из Китая шлюз
401 Не совпадают ключ и адрес Проверить ключ и Base URL
404 Неверный путь Указывать адрес только до /v1
429 Квота или частота Снизить параллельность, повторить, повысить лимит
Ошибка мультимодального запроса Поле или размер не поддерживаются Проверить документацию шлюза, начать с малого файла

8. Прямое подключение и релей

Критерий Прямое подключение Шлюз-релей
Доступ Зависит от сети Доступен из Китая
Оплата Способ провайдера Пополнение в кабинете
Модели Только Gemini Несколько моделей
Счёт Кабинет провайдера Единая консоль
Мультимодальность Полные возможности провайдера Зависит от поддержки шлюза

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

Что дальше

Если нужен доступ из Китая или единая точка входа для нескольких моделей, зарегистрируйтесь в ZSQH AI Gateway и протестируйте текст и мультимодальные запросы на ключе с небольшим лимитом. Модели и цены — на странице тарифов.

Похожие материалы: