Проверить статус

Мультимодальная генерация, например изображений и видео, обычно занимает время. Endpoint создания задачи только создает асинхронную задачу; итоговый статус и результаты получаются через polling.

Запрос

Запрос статуса может использовать status_url из ответа создания задачи или собирать путь из BASE_URL, endpoint и request_id.

Использовать status_url

curl -sS "${STATUS_URL}" \
  "${COMMON_HEADERS[@]}"

Статус по request_id

curl -sS "${BASE_URL}/v1/queue/${ENDPOINT}/requests/${REQUEST_ID}/status" \
  "${COMMON_HEADERS[@]}"

Обработка статуса

Ответ запроса статуса показывает, нужно ли задаче еще ждать, и дает основу для получения результата или обработки ошибок.

Статус	Поведение UI
IN_QUEUE	Задача отправлена и ждет запуска — продолжайте polling
IN_PROGRESS	Задача выполняется — продолжайте polling
COMPLETED	Задача достигла терминального состояния — проверьте error; если его нет, получите результат

Совет

Рекомендуемый интервал polling — каждые 2-5 секунд. Для длинных видео или медленных моделей используйте 5-10 секунд.

Ответ IN_QUEUE

202

{
  "status": "IN_QUEUE",
  "request_id": "mmsu_01hxyz...",
  "queue_position": 0,
  "response_url": "https://.../response"
}

Ответ IN_PROGRESS

202

{
  "status": "IN_PROGRESS",
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://.../response"
}

Ответ COMPLETED

COMPLETED означает только то, что задача достигла терминального состояния. Ответ может означать и успех, и ошибку; определяйте успех по наличию поля error. Примеры:

Успех 200

{
  "status": "COMPLETED",
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://.../response",
  "metrics": {
    "inference_time": 12.34
  }
}

Ошибка 200

{
  "status": "COMPLETED",
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://.../response",
  "error": "Task execution failed",
  "error_type": "INFERENCE_FAILURE"
}

Примечание

metrics.inference_time — наблюдаемая платформой длительность. Она может включать время очереди, планирования и обработки результата, поэтому не считайте ее чистым временем инференса модели.

Типовые значения error_type:

error_type	Значение
INFERENCE_FAILURE	Выполнение модели завершилось ошибкой
INFERENCE_TIMEOUT	Выполнение модели превысило таймаут
REQUEST_INVALID	Параметры запроса некорректны или не соответствуют требованиям модели
CONTENT_BLOCKED	Входной или выходной контент заблокирован политикой безопасности
CANCELED	Задача была отменена
INTERNAL_SERVER_ERROR	Внутренняя ошибка сервера