Генерации

Описание

Генерация — это процесс выполнения запроса к нейросети или ИИ функции с последующим получением результата. В зависимости от типа задачи, модели и выбранного режима работы генерации могут выполняться синхронно, через webhook, обрабатываться асинхронно через очередь или возвращать результат потоково.

Типы генераций

GenAPI поддерживает несколько типов генераций. Тип определяет формат и назначение результата.

Тип генерации указывается в запросе и зависит от выбранной нейросети.

Статусы генераций

Каждая генерация имеет статус, отражающий текущее состояние обработки запроса.

Жизненный цикл генерации

1. Запрос создаётся и получает статус processing
2. После завершения обработки:
   • статус меняется на success, и результат становится доступен
   • либо статус меняется на error, если произошла ошибка

Статус генерации можно получить через API или принять результат автоматически с помощью Webhook.

Ошибки

Если в процессе генерации возникает проблема, статус генерации устанавливается в error. Ошибка означает, что запрос не был успешно выполнен и результат недоступен.

Возможные причины ошибок

• некорректные или неполные параметры запроса;
• неверный или отсутствующий API-ключ;
• превышение лимитов запросов или квот;
• внутренняя ошибка нейросети;
• временная недоступность сервиса.

При повторяющихся ошибках рекомендуется обратиться к документации конкретной нейросети или в поддержку.

Результат генерации

После успешного завершения генерации (status: success) результат становится доступен через API или Webhook.

Для файлов и ссылок на результаты генераций генерируются временные URL:

• Ссылки на отдельные файлы хранятся и доступны для скачивания или просмотра в течение 24 часов
• Полные результаты генерации доступны в течение 14 дней

Убедитесь, что вы сохраняете или скачиваете результаты в течение периода доступности.