Статус задачи медиа

Проверка состояния задачи и получение результата

GET /v1/async/media/tasks/{task_id}

Получить статус media task

cURL

curl --request GET \
  --url https://speshu.ai/api/v1/async/media/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "018f3b...",
    "model": "flux-2/pro-text-to-image",
    "state": "success",
    "createTime": 1715000000000,
    "resultJson": "{\"resultUrls\":[\"https://...\"]}",
    "failCode": "<string>",
    "failMsg": "<string>"
  }
}

Используйте этот эндпоинт, чтобы проверить задачу по taskId.

​

Polling

Проверяйте статус с разумным интервалом:

Тип задачи	Интервал
Изображения	3-5 секунд
Видео	5-10 секунд
Музыка и аудио	5-10 секунд

​

Статусы

Статус	Описание
waiting	Задача ожидает обработки.
processing	Генерация выполняется.
success	Результат готов.
fail	Задача завершилась ошибкой.

​

Пример запроса

curl "https://speshu.ai/api/v1/async/media/tasks/018f3b..." \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>"

​

Ответ success

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "018f3b...",
    "model": "flux-2/pro-text-to-image",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://...\"]}",
    "failCode": null,
    "failMsg": null,
    "createTime": 1715000000000
  }
}

​

Поля ответа

Поле	Тип	Описание
taskId	string	ID задачи.
model	string	Модель, которая выполняла задачу.
state	string	waiting, processing, success или fail.
resultJson	string	JSON-строка с URL результатов. Обычно содержит resultUrls.
failCode	string или null	Код ошибки при fail.
failMsg	string или null	Текст ошибки при fail.
createTime	integer	Время создания задачи в Unix milliseconds.

​

Пример polling

async function waitForTask(taskId, apiKey) {
  while (true) {
    const response = await fetch(
      `https://speshu.ai/api/v1/async/media/tasks/${taskId}`,
      { headers: { Authorization: `Bearer ${apiKey}` } }
    );
    const body = await response.json();
    const task = body.data;

    if (task.state === 'success') {
      return JSON.parse(task.resultJson || '{}');
    }

    if (task.state === 'fail') {
      throw new Error(task.failMsg || 'Задача медиа завершилась ошибкой');
    }

    await new Promise((resolve) => setTimeout(resolve, 5000));
  }
}

​

Ошибки

Код	Описание
401	API-ключ не передан или недействителен.
404	Задача не найдена или не принадлежит текущему пользователю.
422	Неверный taskId.

Авторизации

Authorization · string · header · обязательно

API ключ передаётся в заголовке: Authorization: Bearer <SPESHU_AI_API_KEY>

Параметры пути

task_id · string · обязательно

ID задачи

Ответ

200

application/json

Статус задачи

code · integer · обязательно

Пример:

200

msg · string · обязательно

Пример:

"success"

data · object · обязательно

Show child attributes