---
title: "Получить статус задачи"
method: GET
path: "/api/v1/task/status/{taskId}"
tags: ["Управление задачами"]
---

# Получить статус задачи

`GET /api/v1/task/status/{taskId}`

## Request

- Base URL: `https://api.apihubs.ru`
- URL: `https://api.apihubs.ru/api/v1/task/status/{taskId}`
- Auth: HTTP bearer

Запросить статус выполнения задач по генерации изображений и видео и получить результаты после завершения

## Path parameters

- `taskId` string, required

## Response `200`

Статус задачи успешно получен

- TaskStatusResponseDto
  - `code` number, required: Код состояния HTTP
  - `data` TaskDataDto, required
    - `taskId` string, required: Уникальный идентификатор задачи
    - `status` 'not_started' | 'processing' | 'finished' | 'failed' | 'expired', required: Статус задачи: not_started, processing, finished, failed, expired
    - `files` MediaFileDto[], required: Сгенерированные медиафайлы (заполняется при статусе finished)
      - `fileUrl` string, required: Прямая ссылка на сгенерированный файл (хранится 3 дня)
      - `fileType` 'image' | 'video' | 'music', required: Тип медиафайла: 'image', 'video' или 'music'
    - `output` object, nullable: Структурированные данные результата. Для генерации данных (например, текста песен Suno или созданной персоны) это полный результат. Для генерации медиа они содержат дополнительные метаданные, когда они доступны — например, Suno музыка возвращает `tracks` с названием каждого трека, продолжительностью, текстами песен, тегами и URL-адресами обложек (порядок соответствует `files`).
    - `createdTime` string, required: Отметка времени ISO 8601 создания задачи
    - `errorMessage` string, nullable: Описание ошибки (когда статус завершился с ошибкой)

## Other responses

- `401`: Ошибка авторизации — проверьте API-ключ
- `404`: Задача не найдена

---

[API](https://skmtc.dev/apihubs/apis/api-hubs-api.md) · [All operations](https://skmtc.dev/apihubs/apis/api-hubs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apihubs/apis/api-hubs-api/revisions/d35629798734?raw)