OpenAI API — базовая интеграция для многих AI-приложений, но при прямом подключении из Китая разработчики сталкиваются с сетью, оплатой, лимитами и вопросами комплаенса. Релей для OpenAI API собирает доступ и биллинг в одном шлюзе.

Ниже — что это такое, как выбрать, как перевести код и какие риски встречаются чаще всего.

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

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

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

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

2. Что решает

  • Нестабильный доступ из Китая.
  • Неудобный способ оплаты.
  • Единый счёт и лимиты для команды.
  • Одновременная работа с Claude, Gemini и DeepSeek.
  • Журналы использования и разбор ошибок.

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

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

Критерий Что уточнить
Покрытие моделей Полнота линейки GPT и актуальность версий
Совместимость Chat Completions и Responses, потоковый вывод, вызов инструментов
Стабильность Доля ошибок, P95, ограничения, повторы
Биллинг Как считаются вход, выход и кеш
Лимиты Ограничения для ключей, участников и проектов
Журналы Токены, время и ошибки каждого вызова
Комплаенс Хранение данных, договор, счета

Если вы используете Responses API или новые инструменты, уточните их поддержку отдельно: совместимость с Chat Completions не означает совместимость со всеми новыми интерфейсами.

Для команд с несколькими окружениями полезно сразу разделить ключи по средам: тест, стейджинг и продакшен не должны делить один лимит.

4. Порядок миграции

4.1. Измените Base URL

https://ai.zhongshangqihang.com/v1

4.2. Замените ключ

Создайте ключ в ZSQH AI Gateway и задайте лимит.

4.3. Обновите имя модели

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

4.4. Запустите на малом трафике

Сначала переведите 5–10% запросов, наблюдайте 3–7 дней, затем увеличивайте долю.

Перед миграцией зафиксируйте текущие имена моделей и параметры запросов в конфигурации, а не в коде. Тогда откат сведётся к переключению переменной окружения, а не к правке десятков файлов.

5. Пример на Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-ваш-ключ",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "Ответьте только OK"}],
)
print(resp.choices[0].message.content)

Проверьте, что SDK не добавляет собственные заголовки, которые шлюз может отклонить. Если используется HTTP-прокси, убедитесь, что он не подменяет путь /v1.

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

  1. Обычный и потоковый запрос.
  2. Вызов инструментов и структурированный вывод.
  3. Длинный контекст.
  4. 5, 10 и 20 параллельных запросов.
  5. Коды ошибок 401, 404, 429 и 5xx.
  6. Сверка счёта.

Отдельно проверьте, как шлюз обрабатывает max_tokens, temperature и другие параметры: часть прокси-сервисов молча игнорирует неподдерживаемые поля, и поведение модели меняется незаметно.

7. Риски и типичные ошибки

  • «Дешёвый релей» только для части моделей может отключиться в любой момент.
  • Устаревшие имена моделей и неподдерживаемые параметры приводят к сбоям в продакшене.
  • Утечка ключа быстро расходует баланс — обязательно задавайте лимиты.
  • До корпоративного использования уточните условия обработки данных, счета и комплаенс.
  • Не направляйте весь трафик в один канал — сохраняйте резервный.

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

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

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

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

Нужно ли менять код?

Если используется OpenAI SDK, обычно достаточно изменить Base URL, ключ и имя модели.

Влияет ли релей на качество модели?

Обычно upstream-модель не меняется, но версия канала, параметры и ограничения частоты могут отличаться. Перед миграцией сравните результат на фиксированном наборе тестов.

Можно ли развернуть самостоятельно?

Да, открытые шлюзы New API и One API можно развернуть самостоятельно, но нужны сервер, каналы upstream и эксплуатация. Общие принципы описаны в статье Что такое API-релей.

Что дальше

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

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