Ошибки и повторы

Исследуйте ошибки по коду и ID запроса.

HTTP 429 может означать локальную перегрузку приема, заполненную очередь или ограничение поставщика. Читайте ошибку и Retry-After; это не означает отсутствие лимитов RPM/TPM.

Учитывайте Retry-After, используйте экспоненциальную задержку со случайным разбросом и ограничьте число попыток и общее время. Если видеозадача могла быть создана, сначала проверьте ее ID.

Сохраните x-apivn-request-id, если он есть, и время ошибки. Не включайте API-ключи и конфиденциальные данные в отчеты.

Код ошибки

HTTP	Тип ошибки	Причина
400	invalid_request_error	Неправильный JSON или отсутствуют параметры.
401	authentication_error	Отсутствует ключ, неправильный ключ или отозван ключ.
402	insufficient_balance api_key_monthly_limit outstanding_undercharge	Читайте error.type: insufficient_balance означает недостаток доступных средств; api_key_monthly_limit — достижение месячного лимита ключа; outstanding_undercharge — недоплату по предыдущему запросу, требующую сверки. Лимит ключа проверяйте в Dashboard → Keys; пополнение кошелька не увеличивает его автоматически.
403	model_not_allowed	Этот API-ключ не имеет доступа к выбранной модели. Проверьте разрешения в Dashboard → Keys или выберите разрешённую модель.
413	request_too_large	Тело превышает 20 МБ либо входные данные превышают отдельный лимит модели/провайдера. Прочитайте сообщение и сократите контекст, изображения или файлы. Ошибка 413 возможна и при размере ниже лимита шлюза.
429	rate_limit_error	HTTP 429 может означать локальную перегрузку приема, заполненную очередь или ограничение поставщика. Читайте ошибку и Retry-After; это не означает отсутствие лимитов RPM/TPM.
502	api_error	Невозможно подключить модель от вышестоящего поставщика
503	service_unavailable	Система находится на обслуживании

Ошибка баланса может содержать required_vnd и available_vnd, ошибка лимита ключа — limit_vnd и spent_vnd. Сохраните их вместе с request ID для проверки, не передавая API-ключ.

{
  "type": "error",
  "error": {
    "type": "insufficient_balance",
    "message": "Срок действия баланса истек. Пополните счет на странице https://apivn.dev/dashboard/topup."
  }
}

Поиск неисправностей

Посмотреть статус модели в разделе цен

Сохраните x-apivn-request-id, если он есть, и время ошибки. Не включайте API-ключи и конфиденциальные данные в отчеты.

Симптом	Распространенные причины	Как справиться
404 или «Не найдено»	Неверно вставлен исходный URL-адрес — лишний или отсутствующий /v1.	Инструмент Anthropic использует https://apivn.dev; Инструмент стиля OpenAI с использованием https://apivn.dev/v1.
401 authentication_error	Ключ неправильный, он был отозван или приложение все еще использует старый сохраненный ключ.	Создайте новый ключ на панели управления, удалите старый ключ в приложении, затем перезапустите приложение.
402 insufficient_balance	Нет баланса кошелька.	Пополните счет на странице «Пополнение».
429 rate_limit_error	HTTP 429 может означать локальную перегрузку приема, заполненную очередь или ограничение поставщика. Читайте ошибку и Retry-After; это не означает отсутствие лимитов RPM/TPM.	Учитывайте Retry-After, используйте экспоненциальную задержку со случайным разбросом и ограничьте число попыток и общее время. Если видеозадача могла быть создана, сначала проверьте ее ID.
Claude Code продолжает просить войти в систему	На устройстве все еще есть сеанс входа в старую учетную запись Anthropic.	Запустите /logout в Claude Code, установите ANTHROPIC_AUTH_TOKEN и снова откройте терминал.
Приложение говорит, что модель не существует.	Название модели введено неправильно или приложение автоматически добавляет префикс поставщика.	Вызовите GET /v1/models, чтобы получить точные имена, и удалите префиксы вроде anthropic/, если приложение их не требует.
Произошла ошибка при отправке фотографий	Приложение отправляет фотографии в формате, который не принимает модель, или фотографии слишком большие.	Chỉ dùng model có nhãn Vision, nén ảnh và giữ toàn bộ yêu cầu dưới 20 MB.
Переменные среды не имеют никакого эффекта	Старый терминал по-прежнему сохраняет старое значение, или приложение считывает конфигурацию в отдельном файле.	Откройте новый терминал (Windows: выйдите из системы и войдите снова) и проверьте, есть ли в приложении файл конфигурации, который переопределяет переменные среды.

Примеры проходят проверку исходного кода и локальные проверки; это не подтверждает работу во всех версиях приложений. До эксплуатации проверьте настройки, небольшой запрос и usage.