Почему генерация в Hyper3D завершилась ошибкой

Ошибка генерации в Hyper3D может возникнуть до принятия задачи, во время её обработки или при получении результата клиентом. На каждом из этих этапов причины ошибки и порядок списания кредитов могут различаться. Прежде чем повторить попытку, сохраните точный текст ошибки и идентификатор задачи.

Распространённые причины

  • Изображение или входной 3D-файл повреждены, имеют неподдерживаемый формат, почти полностью прозрачны, слишком малы или не содержат чётко различимого объекта.
  • Промпт или загруженный контент не могут быть обработаны в соответствии с действующими правилами в отношении контента и безопасности.
  • Параметр API, URL файла, формат или сочетание параметров недопустимы для выбранной конечной точки.
  • В выбранном кошельке (Wallet) недостаточно доступных кредитов, отсутствует доступ к модели или необходимое разрешение, предоставляемое подпиской.
  • Обработка прервалась из-за временного сбоя сервиса, загрузки, сети или очереди задач.

Что можно попробовать

  1. Прочитайте сообщение об ошибке целиком, вместо того чтобы многократно отправлять один и тот же запрос.
  2. Для изображений используйте поддерживаемый формат, стабильный URL и непрозрачный объект на переднем плане, который чётко различим. Для текста упростите противоречащие друг другу инструкции.
  3. При работе с API проверьте актуальные имена параметров конечной точки и допустимые значения. Затем опрашивайте полученный UUID задачи до достижения конечного статуса, не принимая промежуточное состояние ожидания за ошибку.
  4. Проверьте нужный личный или командный кошелёк (Team Wallet), доступные и замороженные кредиты, а также историю операций (History).
  5. Если ошибка выглядит временной, подождите немного и повторите попытку один раз.

Кредиты и задачи, завершившиеся ошибкой

В веб-интерфейсе Hyper3D для поддерживаемых рабочих процессов используется подтверждение результата: предварительный просмотр или повторная генерация могут быть бесплатными, за подтверждение списываются кредиты, а неиспользованные замороженные кредиты возвращаются после истечения времени, указанного на таймере. Для задач API проверяйте значение consumed в ответе и запись в кошельке; публичная документация не обещает одинакового порядка возврата кредитов для всех задач, завершившихся ошибкой.

Когда обращаться в поддержку

Если одни и те же корректные входные данные неоднократно приводят к ошибке или за задачу, завершившуюся ошибкой, было неожиданно списано больше кредитов, обратитесь через Feedback или напишите на hello@help.hyper3d.ai. Укажите UUID задачи (или ссылку на ресурс), конечную точку или модель, время запроса, итоговый статус, точный текст ошибки, тип кошелька, запись о списании кредитов и пример входных данных, которым можно безопасно поделиться. Не отправляйте API-ключ, пароль или конфиденциальные платёжные данные.