Частые проблемы при интеграции

Симптомы и решения при подключении llmgw к IDE, чат-приложениям и агентам.

Симптом	Причина и решение
401 Unauthorized	Ключ указан без префикса Bearer или с опечаткой. Проверьте ключ в личном кабинете.
404 model not found	Имя модели не совпадает с каталогом. Сверьтесь с GET https://d-api-3i.llmgw.ru/v1/models или каталогом в кабинете. Используйте формат провайдер/модель, например openai/gpt-4o.
Инструмент «не видит» модели	В инструменте включён список моделей по умолчанию (OpenAI). Добавьте модели вручную с точными именами из каталога.
Обрыв длинных ответов	Увеличьте max_tokens в настройках инструмента.
429 Rate limit	Достигнут RPM-лимит ключа. Проверьте лимиты в кабинете или создайте отдельный ключ с более высоким лимитом.
Баланс есть, но запросы отклоняются	Баланс организации нулевой или ключ заблокирован. Проверьте баланс и статус ключа.
Cursor Verify не проходит	Отключите в списке модели Cursor, которых нет в llmgw. Verify проверяет первую активную модель.
Запросы идут не через llmgw	Проверьте Base URL — должен быть ровно https://d-api-3i.llmgw.ru/v1 без лишнего /chat/completions на конце (кроме JetBrains ProxyAI, где нужен полный path).

Быстрая диагностика через curl

# Список моделей
curl https://d-api-3i.llmgw.ru/v1/models -H "Authorization: Bearer sk-llmgw-..."

# Тестовый запрос
curl https://d-api-3i.llmgw.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-llmgw-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-4o","messages":[{"role":"user","content":"ping"}]}'

Если curl работает, а IDE — нет, проблема в настройках инструмента (Base URL, имя модели, лишние модели в списке).

Куда обращаться

• Обработка ошибок API — коды ответов и стратегия ретраев.
• FAQ — общие вопросы по биллингу и доступу.
• Поддержка: email из реквизитов в кабинете.