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

Ниже распространённые решения разделены на три класса: прямое подключение, собственный прокси и локальный AI-шлюз; для каждого указаны границы применимости, работа с квотами и порядок запуска. Короткий вывод: на этапе прототипа допустим удобный вариант, а в продакшене выбирайте решение, которое можно мониторить, деградировать и объяснить с точки зрения комплаенса.

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

1. Сравнение трёх решений

Критерий Прямое официальное подключение Собственный прокси Локальный AI-шлюз
Типичная доступность Сильно зависит от сети и региона Зависит от качества выхода Обеспечивается поставщиком, есть статус-страница
Задержка Заметно колеблется Можно оптимизировать, но добавляется переход Обычно стабильнее
Стоимость эксплуатации Низкая, но диагностика сложна Высокая: сервер и выходной канал Низкая, оплата по интерфейсу
Квоты Официальные лимиты скорости и региона Официальную квоту не меняет Распределяет и ограничивает шлюз
Биллинг Доллары, оплата по факту Официальная стоимость плюс сервер Юани, предоплата
Объяснение комплаенса Нужно самостоятельно описать трансграничный канал Ответственность за выход и журналы на вас Есть местный договор и границы сервиса
Сценарии Личная проверка, малая чувствительность Внутренние системы с сетевой командой Клиентский продакшен

Таблица не принимает решение за вас, а напоминает: прокси решает только «соединение есть», но не квоты, счета и комплаенс. Если считать прокси долгосрочным производственным решением, неопределённость остаётся в канале.

2. Прямое подключение: сначала сеть или права

Прямое подключение чаще всего сбоит в трёх случаях; соблюдайте порядок диагностики:

  1. Регион недоступен: в регионах, не охваченных сервисом, запрос может завершиться тайм-аутом или отказом; смена ключа не поможет.
  2. Сеть не проходит: проблемы возможны на этапе DNS, TLS-рукопожатия и маршрутизации выхода; curl -v покажет, где именно застрял запрос.
  3. Ошибка аутентификации или проекта: 401 указывает на ключ, 403 чаще связан с проектом, невключённым API или правами на модель.
export GEMINI_API_KEY="ваш ключ"

curl -v "https://generativelanguage.googleapis.com/v1beta/models" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  --max-time 15

Если тайм-аут наступает уже на этапе соединения, менять параметры дальше бессмысленно; если соединение есть, но возвращается 4xx, разбирайте по коду состояния. Записывайте этап отказа, длительность и код, чтобы отличить случайные колебания от структурной недоступности.

3. Собственный прокси: решает связность, не квоты

Типичная схема: бизнес-сервер → зарубежный выход → Gemini API. Она подходит командам с сетевой эксплуатацией и контролируемой чувствительностью данных, но четыре пункта нужно внести в регламент:

  • Стабилен ли выходной IP и не расценит ли целевой сервис трафик как аномальный.
  • Записывает ли прокси содержимое запросов, сколько хранятся журналы и кто имеет к ним доступ.
  • Как управляются сертификаты, домены и порты и как оповещать об истечении срока.
  • Пропускная способность, параллелизм и переключение при сбое самого прокси-сервера.

Прокси не увеличивает официальную квоту. Ограничения RPM и TPM бесплатного или младшего уровня сохраняются, в пик всё равно будет очередь. Чаще встречается другая проблема: все сервисы используют один выход, и один вышедший из-под контроля скрипт перегружает весь канал; поэтому выходы и лимиты нужно разделять по сервисам.

4. Подключение через шлюз: обычно меняются три вещи

Локальный AI-шлюз обычно предоставляет вход, совместимый с OpenAI; в существующем коде достаточно изменить Base URL, ключ и имя модели:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZSQH_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="<имя модели Gemini со страницы тарифов>",
    messages=[{"role": "user", "content": "Ответь только OK"}],
    max_tokens=64,
)
print(resp.choices[0].message.content)
print(resp.usage)

Имя модели берите со страницы тарифов, не копируйте из примера. После подключения выполните минимальный запрос, затем пакет реальных задач и смотрите на три вещи: задержку до первого байта, долю ошибок и не ухудшился ли вывод. Шлюз — это граница сервиса; до выбора проверьте статус-страницу, каналы поддержки, правила возврата и условия обработки данных.

5. Квоты и 429: правильно настройте повторы

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

  1. Экспоненциальная задержка со случайным разбросом, чтобы все клиенты не повторяли одновременно.
  2. Максимальное число повторов и общий тайм-аут; при превышении — деградация, а не бесконечная отправка.
  3. Очередь по приоритету бизнеса: интерактивные запросы важнее офлайн-пакетов.
  4. Идемпотентность операций записи, чтобы повторы не создавали дублирующиеся эффекты.
  5. Мониторинг распределения 429 по времени: минутный лимит или исчерпание дневной квоты.
  6. Резервная модель или канал с автоматическим переключением при ограничении основного.

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

6. Комплаенс и данные: три обязательных вопроса

  1. Есть ли в запросах персональные данные, клиентские договоры, код или финансовые данные?
  2. Через какие узлы проходят данные, в каких регионах хранятся и сколько живут журналы?
  3. При инциденте безопасности кто предоставит записи и как быстро уведомит?

Чем длиннее трансграничный канал, тем дороже объяснение. Для клиентских систем классифицируйте данные и обезличивайте чувствительные поля; если журналы нужно хранить, определите права доступа и порядок удаления. Не пропускайте комплаенс-оценку под предлогом «мы всего лишь вызываем API».

7. Порядок запуска

  1. Проведите недельный нагрузочный тест на реальных задачах, охватив пик и спад.
  2. Зафиксируйте успешность, задержки p50 и p95, распределение 429 и стоимость задачи.
  3. Сравните верхнюю границу квоты с бизнес-пиком и оставьте запас.
  4. Подключите мониторинг и оповещения: ошибки, задержка, баланс и ограничения.
  5. Отработайте переключение основной и резервной систем, проверьте приемлемость деградации.
  6. Заархивируйте договор, счета, условия обработки данных и описание безопасности.
  7. Переводите трафик постепенно и расширяйте после недели наблюдения.

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

Можно ли вызывать Gemini API из Китая напрямую?

Возможность прямого подключения зависит от региона обслуживания, сетевого выхода и статуса аккаунта; на практике возможны тайм-ауты, сброс соединения или 4xx. Не делайте вывод по одному успеху или сбою — оценивайте недельное распределение ошибок и задержек.

Стабилен ли доступ через прокси?

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

Почему постоянно возвращается 429?

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

Меняет ли шлюз возможности модели?

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

Какие комплаенс-вопросы важны при доступе из Китая?

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

Что дальше

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

Читайте также: