Ошибка: что делать

ПомощьНовичок3 мин

Найдите в таблице, что видите, — рядом написано, что сделать.

1Проверьте за минуту

1
Сервис работает?
Откройте api.zukko.pro/api/status: ok — да, degraded — часть моделей со сбоями, maintenance — технические работы.
2
Ключ работает?
Бесплатная проверка:
bash
curl https://api.zukko.pro/v1/balance -H "Authorization: Bearer fetch_..."
Пришёл баланс — ключ в порядке, 401 — нет.
3
Модель есть?
Сверьте имя с api.zukko.pro/v1/models буква в букву.

2Ошибки

Что видите	Что сделать
`401`, «Invalid API key»	Ключ с опечаткой или отозван. Скопируйте заново или создайте новый
`402`, `insufficient_balance`	Пополните баланс — перезапуск не нужен
`403`, `email_unverified`	Подтвердите почту по ссылке из письма
`403`, `model_not_allowed_for_key`	Разрешите модель в настройках ключа
`429`, `key_daily_limit_reached` / `key_monthly_limit_reached`	Сработал ваш лимит на ключ. Поднимите его или дождитесь сброса: 00:00 UTC (03:00 МСК) или 1-го числа
`429` без кода Zukko, «rate limit»	Модель перегружена. Повторите через 10–30 секунд или возьмите другую
`404`, `model_not_found`	Опечатка в имени. Сверьте со списком моделей
`400`, `model_retired`	Модель снята — в тексте ошибки написано, на какую перейти
`503`, `model_disabled`	Модель выключена — возьмите другую
`502`, `503`, другие 5xx	Модель временно не отвечает. Повторите через 10–30 секунд или возьмите одну из моделей, перечисленных в тексте ошибки
`503`, `maintenance`	Технические работы, повторите минут через 10
Долго нет ответа, timeout	Сильные модели думают 30–60 секунд. Поставьте таймаут 120–300 секунд и включите стриминг
`413`, `payload_too_large`	Запрос больше 32 МБ — уменьшите картинки или файлы
Ответ обрывается	Увеличьте `max_tokens`

Ошибки не оплачиваются. Все коды — Ошибки API.

3Claude Code, Cursor и другие программы

Режим	Адрес
Anthropic (Claude Code, Roo Code)	`https://api.zukko.pro` — без `/v1`
OpenAI (Cursor, Cline, Codex)	`https://api.zukko.pro/v1` — с `/v1`

Перепутали — будет 404 на каждый запрос.

Что видите	Что сделать
Claude Code просит войти в Anthropic	Ключ — в `ANTHROPIC_AUTH_TOKEN`, не `ANTHROPIC_API_KEY`. Проверьте запятые в `settings.json`. Выполните `/logout`
Cursor ходит мимо Zukko	Включите Override OpenAI Base URL с `https://api.zukko.pro/v1`. Нужен Cursor Pro
Cursor не даёт добавить модель	Используйте имена для Cursor: `cursor-sonnet-5`, `cursor-opus-55`

4Сайт не открывается

Попробуйте другую сеть (мобильный интернет вместо Wi-Fi) или пользуйтесь Zukko в Telegram: @zukkopro_bot — там есть пополнение и чат с моделями.

5Оплатили, а баланс не пополнился

Подождите 2–5 минут и обновите страницу оплаты.
Сохраните номер заказа со страницы результата («Заказ: …») и чек.
Через 10–15 минут денег нет — напишите в поддержку: номер заказа, сумма, способ, время. По правилам обращайтесь в течение 24 часов.

6Поддержка

Telegram — быстрее всего, или почта zukkopro@rambler.ru. Напишите:

время ошибки с часовым поясом;
где: Claude Code, Cursor, свой код, веб-чат, бот;
модель и полный текст ошибки (можно скриншот);
id ответа (chatcmpl-… или msg_…), если есть;
последние 4 символа ключа.

GET /api/status

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