Создать медиа сессию

Группировка связанных задач медиа в одну сессию

POST /v1/media/sessions

Создать media session

cURL

curl --request POST \
  --url https://speshu.ai/api/v1/media/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "My Project"
}
'

200

{
  "code": 200,
  "msg": "success",
  "data": {
    "sessionId": "018f3a...",
    "title": "My Project"
  }
}

Сессия помогает объединять связанные задачи. Например, один проект с несколькими изображениями, видео и аудио.

​

Тело запроса

Поле	Тип	Обязательное	Описание
title	string	Нет	Название сессии.

​

Пример

curl -X POST "https://speshu.ai/api/v1/media/sessions" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Запуск кампании"
  }'

​

Ответ

{
  "code": 200,
  "msg": "success",
  "data": {
    "sessionId": "018f3a...",
    "title": "Запуск кампании"
  }
}

Передайте sessionId в POST /async/media/tasks, чтобы привязать задачу к сессии.

Авторизации

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

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

Тело

application/json

title · string

Название сессии

Пример:

"My Project"

Ответ

200

application/json

Сессия создана

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

Пример:

200

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

Пример:

"success"

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

Show child attributes