Ошибки hiapi «модель недоступна»/«модель не найдена»: причины и способы исправления

Если POST https://api.hiapi.ai/v1/tasks отклоняет запрос из-за недоступности модели или недопустимого запроса, задача не создаётся. Перед повторной попыткой сверьте точное имя модели и поля запроса с актуальной документацией модели.

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

1. Имя модели устарело или неполно. Не все имена моделей HiAPI имеют одинаковую форму. Некоторые представляют собой голые имена, другие содержат модальный путь. Для запроса текста в изображение в GPT Image 2 используется gpt-image-2/text-to-image.
2. Опечатки, различия в регистре или скрытые пробелы изменили имя. Копируйте имя модели из актуальной документации, не вводите его по памяти и удаляйте пробелы из значений, загружаемых из переменных окружения.
3. Модель или маршрут были отключены или переименованы. Имена из старых статей или сохранённых фрагментов могут быть недоступны. Ориентируйтесь на актуальную страницу модели и журнал изменений.
4. Запрос смешивает форматы маршрутизации. Если модель поддерживает несколько маршрутов, используйте указанное в документации поле верхнего уровня route или поддерживаемую форму @route, но не отправляйте конфликтующие значения.
5. Аутентификация не прошла до маршрутизации. 401 означает, что API-ключ отсутствует или недействителен. 403 означает, что у ключа нет прав. Рассматривайте эти случаи отдельно от полей модели.

Шаги исправления

1. Откройте актуальную документацию GPT Image 2 или соответствующую страницу модели и скопируйте точное имя модели.
2. Сохраняйте модальный суффикс, являющийся частью имени в документации. Для текста в изображение в GPT Image 2 используйте gpt-image-2/text-to-image.
3. Сравните каждое поле в input с таблицей параметров этой модели. Даже при допустимом имени модели неподдерживаемое поле ввода может вернуть 400 INVALID_REQUEST.
4. Удаляйте пробелы в месте вызова. В Python используйте model = os.environ["MODEL"].strip(); в Node.js используйте model.trim().
5. Если у модели несколько маршрутов, передайте указанное в документации значение верхнего уровня route и используйте структуру параметров, соответствующую этому маршруту.
6. Записывайте полный HTTP-статус и тело ответа. Не делайте вывод о проблеме с ключом из ошибки проверки модели и о проблеме с моделью из 401/403.

Проверка минимальным запросом

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "a small ceramic mug on a wooden table, soft window light",
      "aspect_ratio": "1:1",
      "resolution": "1K"
    }
  }'

Ответ HTTP 200 с data.taskId означает, что задача принята. Опрашивайте GET /v1/tasks/:id, пока data.status не станет success или fail, либо настройте обратный вызов для рабочей среды. Если возвращается 400, прочитайте сообщение проверки и перепроверьте страницу модели. Если возвращается 401 или 403, исправьте ключ или его права.

Связанные материалы

• Документация модели GPT Image 2
• Справочник API создания задач
• Руководство по аутентификации
• Обзор моделей HiAPI

Часто задаваемые вопросы

Следует ли удалять /text-to-image из каждого имени модели? Нет. Именование моделей различается по семействам. Копируйте фиксированное значение из актуальной документации модели. Для текста в изображение в GPT Image 2 /text-to-image является частью имени модели.

Означает ли ошибка модели, что мой ключ неверен? Не обязательно. Проверка запроса и аутентификация разделены. 401 означает, что ключ отсутствует или недействителен; 403 означает, что у ключа нет прав. 400 указывает на структуру запроса, имя модели, маршрут или поля ввода.

Могу ли я нормализовать все имена моделей на стороне клиента? Избегайте создания собственных правил нормализации. Храните и отправляйте точные имена, опубликованные в актуальной документации модели.