Перейти к основному содержанию
GET
/
v1
/
async
/
media
/
tasks
Получить список media tasks
curl --request GET \
  --url https://speshu.ai/api/v1/async/media/tasks \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": {
    "items": [
      {
        "taskId": "018f3b...",
        "model": "flux-2/pro-text-to-image",
        "state": "success",
        "createTime": 1715000000000,
        "resultJson": "{\"resultUrls\":[\"https://...\"]}",
        "failCode": "<string>",
        "failMsg": "<string>"
      }
    ],
    "total": 42
  }
}

Documentation Index

Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Query параметры

ПараметрТипПо умолчаниюОписание
limitinteger20Количество задач. Максимум 100.
offsetinteger0Смещение для пагинации.
statusstring-Фильтр по статусу: waiting, processing, success, fail.
modelstring-Фильтр по ID модели.
orderstringdescСортировка: asc или desc.

​
Пример

curl "https://speshu.ai/api/v1/async/media/tasks?limit=10&status=success" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>"

​
Ответ

{
  "code": 200,
  "msg": "success",
  "data": {
    "items": [
      {
        "taskId": "018f3b...",
        "model": "flux-2/pro-text-to-image",
        "state": "success",
        "resultJson": "{\"resultUrls\":[\"https://...\"]}",
        "failCode": null,
        "failMsg": null,
        "createTime": 1715000000000
      }
    ],
    "total": 42
  }
}
Объекты в items имеют тот же формат, что и ответ GET /async/media/tasks/{task_id}.

Авторизации

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

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

Параметры запроса

​
limit
integer
по умолчанию:20
Требуемый диапазон: x <= 100
​
offset
integer
по умолчанию:0
​
status
enum<string>
Доступные опции:
waiting,
processing,
success,
fail
​
model
string
​
order
enum<string>
по умолчанию:desc
Доступные опции:
asc,
desc

Ответ

Список задач

​
code
integer
обязательно
Пример:

200

​
msg
string
обязательно
Пример:

"success"

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