Блог Zukko
Гайды по Claude Code, Cursor, Codex и API Claude и GPT: настройка, экономия токенов, разбор ошибок.
Ошибка 503 model_disabled: что это и как её обработать
4 мин · · ошибки
model_disabled значит, что конкретная модель сейчас выключена, а не что упал весь сервис. Как найти замену, переключить IDE и написать код с запасной моделью.
Как отлаживать запросы к API нейросети: от curl до кодов ошибок
5 мин · · разработка
Чаще всего проблема не в модели, а в запросе: адрес, ключ, лимит, размер тела. Пошаговый порядок отладки и таблица кодов ошибок Zukko с решениями.
Логирование LLM-запросов без утечки персональных данных
4 мин · · разработка
Логи нужны для отладки и учёта расходов, но в запросах к модели часто есть личные данные. Показываем, что логировать, как маскировать и как хранить.
Ошибка insufficient_quota в OpenAI API: причины и как её убрать
5 мин · · ошибки
Ошибка insufficient_quota приходит с кодом 429, но это не rate limit, а деньги или лимит расходов. Разбираем причины, точные коды и обработку в Python.
Ошибка 529 overloaded у Claude: что значит и как её пережить
6 мин · · ошибки
Ошибка 529 у Claude — не ваш лимит и не ваш баланс, а перегрузка API. Разбираем, как повторять запрос, когда переключаться на резервную модель и что вы увидите через шлюз.
Обработка ошибок LLM API: retry, 429, 503 и запасная модель
5 мин · · ошибки
Не каждую ошибку стоит повторять, и не каждую можно пережить на той же модели. Разбираем коды Zukko, паузы между попытками и цепочку резервных моделей с кодом.
Ошибки при отправке изображений в vision-модели
4 мин · · ошибки
Запрос с картинкой ломается не так, как обычный текстовый. Разбираем, где именно теряются изображения при вызове API и как это видно в ответе сервера.
Код 499: клиент оборвал соединение раньше ответа
4 мин · · ошибки
Ответ пришёл наполовину и пропал — знакомая картина при долгой генерации. Разбираем, почему это почти никогда не лимит токенов, а таймаут на стороне клиента.
Ошибка 403 model_not_allowed_for_key
4 мин · · ошибки
Ключ рабочий, баланс есть, а модель отвечает 403. Разбираем, как список разрешённых моделей привязывается к конкретному ключу и как это поправить.
Ошибка 422 idempotency_conflict: что значит и как чинить
4 мин · · ошибки
Повторили запрос с тем же ключом идемпотентности, но с другим телом — и получили 422 вместо ожидаемого повтора ответа. Разбираем, что происходит.
Ошибка model_retired: модель сняли с обслуживания
4 мин · · ошибки
Модель, которая работала вчера, сегодня отвечает 400 с кодом model_retired. Разбираем, что это значит и как обработать это в коде, а не руками.
Ошибка 413: запрос слишком большой — как обойти
4 мин · · ошибки
413 почти всегда означает не проблему с ключом или моделью, а раздутое тело запроса. Разбираем, откуда берётся лишний вес и как его убрать.
Ограничения на размер и формат изображений: частые ошибки
5 мин · · изображения
Ошибка с картинкой почти никогда не называет точную причину прямо. Разбираем, где реально теряются изображения на входе и как это отладить быстро.
Ошибка 503 — провайдер модели недоступен
2 мин · · ошибки
503 говорит, что проблема не у вас. Разбираем, как её пережить без потери данных и почему при стриминге ошибка приходит с кодом 200.
Ошибка context_length_exceeded — переполнен контекст
2 мин · · ошибки
Модель отказалась отвечать, потому что запрос не помещается. Разбираем, из чего складывается контекст и что резать в первую очередь.
Ошибка 429 Too Many Requests — что делать
2 мин · · ошибки
429 — это не поломка, а просьба подождать. Разбираем, как повторять запрос правильно и почему агентные сценарии ловят её чаще остальных.
Ошибка 401 Invalid API key — почему ключ не работает
2 мин · · ошибки
Ключ скопирован, а сервер отвечает 401. Разбираем пять причин по частоте и показываем, как проверить ключ одной командой.
Claude Code просит войти в Anthropic — как это убрать
2 мин · · claude-code
Claude Code упорно предлагает войти в аккаунт Anthropic, хотя ключ прописан. Дело в одной переменной окружения.
Ответ модели обрывается на середине — причины
2 мин · · ошибки
Ответ обрывается на полуслове. Причин четыре, и различаются они по одному полю в ответе API.
Cursor не видит модели после смены base URL
2 мин · · cursor
Ключ вставлен, адрес заменён, а список моделей пустой или проверка не проходит. Четыре причины по частоте.
401, 402, model not found: разбор ошибок подключения к API
3 мин · · ошибки
Почти все проблемы первого подключения сводятся к четырём ошибкам. Разбираем каждую и что именно её вызывает.
Base URL с /v1 или без — куда какой адрес
2 мин · · подключение
Один и тот же шлюз требует разного base URL в разных клиентах. Ошибка на один суффикс даёт 404 без внятного объяснения.