Создать задачу медиа

Запуск асинхронной генерации изображений, видео, музыки и аудио

POST /v1/async/media/tasks

Создать media task

cURL

curl --request POST \
  --url https://speshu.ai/api/v1/async/media/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "flux-2/pro-text-to-image",
  "input": {},
  "sessionId": "018f3a...",
  "callBackUrl": "https://example.com/webhook"
}
'

200

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "018f3b..."
  }
}

​

О Media API

Media API запускает генерацию через единый асинхронный контракт. Вы выбираете модель, передаёте параметры в input и получаете taskId.

Используйте taskId, чтобы проверить статус и забрать результат через GET /async/media/tasks/{task_id}.

​

Базовый URL

https://speshu.ai/api/v1

​

Авторизация

Передавайте API-ключ в заголовке:

Authorization: Bearer <SPESHU_AI_API_KEY>

​

Тело запроса

Поле	Тип	Обязательное	Описание
model	string	Да	ID модели из каталога GET /media/models.
input	object	Да	Параметры генерации. Схема зависит от модели.
sessionId	string	Нет	ID сессии из POST /media/sessions.
callBackUrl	string	Нет	URL вебхука, который будет вызван после завершения задачи.

​

Пример

curl -X POST "https://speshu.ai/api/v1/async/media/tasks" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2/pro-text-to-image",
    "input": {
      "prompt": "Фотореалистичный закат над горным озером",
      "aspect_ratio": "1:1",
      "resolution": "1K"
    }
  }'

​

Пример с сессией и вебхуком

{
  "model": "bytedance/seedance-1.5-pro",
  "input": {
    "prompt": "Камера медленно движется над ночным городом",
    "aspect_ratio": "16:9",
    "duration": 5
  },
  "sessionId": "018f3a...",
  "callBackUrl": "https://example.com/webhooks/speshu"
}

​

Ответ

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "018f3b..."
  }
}

​

Ошибки

Код	Описание
401	API-ключ не передан или недействителен.
402	Недостаточно средств на балансе.
422	Неверная модель или параметры input.
500	Внутренняя ошибка сервера.

Авторизации

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

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

Тело

application/json

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

ID модели

Пример:

"flux-2/pro-text-to-image"

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

Параметры генерации. Схема зависит от модели.

sessionId · string

ID сессии

Пример:

"018f3a..."

callBackUrl · string

URL вебхука после завершения задачи

Пример:

"https://example.com/webhook"

Ответ

200

application/json

Задача создана

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

Пример:

200

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

Пример:

"success"

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

Show child attributes