# Переезд на NormaHub за вечер

> Короткий ответ: Переезд — это смена адреса и ID модели с прогоном чеклиста за вечер: список, запрос, поток, ошибка, usage, лимит. Не сошлось — трафик не переключать.

Переезд между OpenAI-совместимыми API — самая дешёвая миграция в индустрии, если делать её чеклистом, а не на глаз. Шесть шагов на вечер: адрес, ключ, модели, smoke-тест, лимиты, параллельный прогон. Разбираем каждый с проверками — и когда останавливаться.

- Категория: Практика
- Автор: Редакция NormaHub
- Техническая проверка: Техническая проверка NormaHub
- Опубликовано: 2026-10-01
- Обновлено: 2026-10-01

## Адрес, ключ, модели

Модель храните константой в одном месте кода — тогда переезд начинается с трёх строк: base_url на адрес gateway, ключ из переменных окружения, model ID из каталога или ответа списка моделей. ID из чужих статей не копируйте: они устаревают и дают «модель не найдена» в самый неподходящий момент.

Для Claude-клиентов адрес без суффикса на конце, для OpenAI-совместимых — с ним: путь добавляет сам клиент, и перепутанный суффикс — самая частая причина «всё настроено, ничего не работает». Ключ — отдельный, свежий, с лимитом: миграция не повод тащить старый общий ключ.



- модель — константа в одном месте

- ID — из каталога, не из статей

- Claude — адрес без суффикса, остальным — с ним

- ключ — свежий отдельный с лимитом

## Smoke-тест и лимиты

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

Лимиты ставьте до трафика: spend limit на ключ чуть выше сметы пикового дня, rate limit на пользователя и глобальный — под вашу нагрузку. Без лимитов первый же зацикленный вызов после переезда покажет, где вы ошиблись в смете.



- шесть галочек по порядку

- ошибку проверять намеренно

- лимиты до трафика

- spend limit чуть выше пикового дня

## Параллельный прогон и откат

Не переключайте трафик сразу: погоняйте дублирующий процент запросов новым маршрутом сутки и сравните ответы, ошибки и счёт. Начните с 1–5% некритичного трафика, затем половина, затем всё. Расхождение ответов — не всегда баг нового маршрута: сверяйте с ожидаемым поведением, а не со старым один в один.

Откат — это возврат трёх строк: прежний адрес, ключ, ID. Держите его готовым первую неделю: старый ключ не отзывайте сразу, лимиты на нём оставьте. Через неделю стабильной работы старый маршрут гасите, ключ отзывайте. Переезд завершён, когда старый путь удалён из кода, а не когда «вроде работает».



- дублирующий процент сутки, затем половина

- расхождение — сверять с ожидаемым, не со старым

- откат — три строки, неделю держать готовым

- старый путь удалён из кода — переезд завершён

## Источники

- [Документация API](/docs)
- [Первый запрос на Python](/guides/python)

## Следующие шаги

- [Гайд по ошибкам API](/guides/errors)
- [Модели и цены](/models)