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

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

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

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

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

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

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