Загрузка видео

Загружает видео и ставит его в очередь на обработку.

В ответе возвращается идентификатор загруженного видео — используйте его, чтобы отслеживать статус обработки через GET /v1/videos/{video_id} и привязывать видео к товару через media в POST /v1/variants и PATCH /v1/variants/{id}.

Ограничения

  • максимальный размер файла — 100 МБ;
  • поддерживаемые форматы: mp4, mov, webm, avi, flv;
  • видео дедуплицируются по содержимому: повторная загрузка того же файла не создает дубликат, а возвращает уже загруженное видео;

Request

POST

https://api.kit.yandex.net/v1/videos

Body

multipart/form-data
{
  "file": "example"
}

Name

Description

file

Type: string<binary>

Файл видео для загрузки

Example: example

Responses

201 Created

Видео успешно загружено

Body

application/json
{
  "video_id": "vplvusemmooxmhpwiqli"
}

Name

Description

video_id

Type: VideoID

Идентификатор видео.

Min length: 1

Example: vplvusemmooxmhpwiqli

VideoID

Идентификатор видео.

Type: string

Min length: 1

Example: vplvusemmooxmhpwiqli

400 Bad Request

Некорректный запрос.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

401 Unauthorized

Не авторизован.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000