Heli
Создать аккаунт

Ошибка invalid model / model not found в Heli API: правильный slug модели

Поле model в запросе к Heli — это слаг из каталога в формате vendor/model: openai/gpt-5.4-mini, anthropic/claude-sonnet-5, deepseek/deepseek-v4-flash. Если слаг не совпадает с каталогом, запрос не дойдёт до модели и вернётся с ошибкой. Почти всегда причина — короткое имя модели из примеров для другого API, опечатка или модель, которой уже нет в каталоге.

Как выглядит ошибка

Неизвестный слаг возвращается ошибкой с type server_error и HTTP-статусом 502, а в поле message — текст о неверном идентификаторе модели. Такой 502 повторять бессмысленно: исправьте поле model. Ошибка 400 с кодом model_denied означает другое — модель существует, но запрещена политикой вашего ключа или проекта во вкладке «Лимиты».

code
# Неправильно: короткое имя без vendor/
{"model": "gpt-4", "messages": [...]}

# Правильно: слаг из каталога Heli
{"model": "openai/gpt-5.4-mini", "messages": [...]}

Как найти правильный слаг

  • Страница модели на getheli.ru/models — слаг указан в примере запроса.
  • GET /v1/models с вашим ключом возвращает список моделей с полями id и kind (chat, embeddings, transcription, speech). Если у ключа настроен allowlist, список уже отфильтрован по нему.
  • Для эмбеддингов, распознавания и озвучки нужен слаг соответствующего kind: модель чата не подойдёт для /v1/embeddings.
curl
curl -s https://getheli.ru/v1/models \
  -H "Authorization: Bearer $HELI_API_KEY" | jq -r '.data[] | select(.kind=="chat") | .id'

Каталог моделей

Отладка Heli API через curl

Частые причины

  • Короткое имя (gpt-4o, claude-3-5-sonnet) из документации другого API. В Heli нужен полный слаг с префиксом. Без префикса принимаются только несколько алиасов, например text-embedding-3-small и whisper-1.
  • Устаревший слаг: каталог обновляется, старые версии моделей уходят. Сверьте id через /v1/models.
  • Опечатка, лишний пробел или перенос строки в значении из конфига.
  • Инструмент меняет имя модели: например, некоторые SDK агентов отрезают префикс openai/ у строкового имени модели. Проверьте итоговое значение model в логах запроса.

Как не ловить ошибку в проде

  • Храните слаг модели в конфиге, а не в коде, и проверяйте его при старте сервиса запросом к /v1/models.
  • Перед обновлением каталога в своём продукте прогоняйте короткий тестовый запрос к каждой используемой модели.
  • Для критичных сценариев держите запасную модель другого вендора и переключайтесь на неё при ошибке.

GPT-5.4 mini

Claude Sonnet 5

DeepSeek V4 Flash

Глоссарий: slug модели

Попробуйте Heli

Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.

Создать аккаунтВойти

Документация API · Модели и цены

Читайте также