Загрузки

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

На этой странице

Начать загрузку
Загрузить файл по одноразовой ссылке
Загрузить файл целиком
Загрузить часть
Завершить загрузку по частям
Загрузить файл по адресу
Статус загрузки
Отменить загрузку
Схемы

Загрузка — видео, фото или аудио, из которого собирается монтаж. Сначала загрузка создаётся (createUpload), затем файл отправляется одним из способов, после проверки статус становится ready. Как выбрать способ и обработать ошибки — в руководстве Загрузка файлов.

Начать загрузку

POST/v1/uploads

Области доступа: projects:write
Лимит: обычный

Возвращает загрузку и одноразовую ссылку uploadUrl. Дальше — PUT всего файла на uploadUrl (без токена) или на /v1/uploads/{id}/content, либо части по 8 МиБ на /v1/uploads/{id}/parts/{n} и complete.

Тело запроса `CreateUploadRequest`

Поле	Тип	Описание
`fileName`обязательное	`string`	Имя файла с расширением: по нему определяется вид≤ 255
`size`обязательное	`integer`	Размер файла, байт≥ 1
`mimeType`	`string`	≤ 128
`purpose`	`string`	`source` (по умолчанию) — материал монтажа`source` · `media` · `music`

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/uploads" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fileName":"interview.mp4","size":104857600}'

const response = await fetch('https://api.slicer.media/v1/uploads', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileName": "interview.mp4",
    "size": 104857600
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/uploads",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "fileName": "interview.mp4",
        "size": 104857600,
    },
)
body = response.json()

Ответ

Поля ответа: CreatedUpload (3)

Поле	Тип	Описание
`upload`обязательное	`Upload`
`uploadUrl`обязательное	`string (uri)`	Одноразовая ссылка: `PUT` всего файла без токена (≤ 1 ч, только запись)
`uploadUrlExpiresAt`обязательное	`string`	Дата и время ISO 8601, UTC

Пример ответа

{
  "ok": true,
  "data": {
    "upload": {
      "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
      "fileName": "interview.mp4",
      "purpose": "source",
      "origin": "client",
      "sizeBytes": 104857600,
      "status": "uploading",
      "partSize": 104857600,
      "partCount": 13,
      "uploadedParts": [
        1
      ],
      "progress": 0.5,
      "media": {
        "kind": null,
        "durationSec": null,
        "width": null,
        "height": null,
        "hasAudio": null
      },
      "error": "string",
      "createdAt": "2026-10-16T09:30:00Z"
    },
    "uploadUrl": "https://api.slicer.media/v1/…",
    "uploadUrlExpiresAt": "2026-10-16T09:30:00Z"
  }
}

Загрузить файл по одноразовой ссылке

PUT/v1/upload-links/{secret}

Области доступа: без токена
Лимит: обычный

Без токена: разрешение — секрет в адресе. Только запись, один файл, ≤ 1 ч. curl -T video.mp4 <uploadUrl>

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

Поле	Тип	Описание
`secret`обязательное	`string`

Тело запроса

Байты файла (application/octet-stream).

Запрос

curl

JavaScript

Python

curl -X PUT "https://api.slicer.media/v1/upload-links/upl_…" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @video.mp4

import { readFile } from 'node:fs/promises';

const response = await fetch('https://api.slicer.media/v1/upload-links/upl_…', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/octet-stream',
  },
  body: await readFile('video.mp4'),
});
const { ok, data, error } = await response.json();

import requests

with open("video.mp4", "rb") as file:
    response = requests.put(
        "https://api.slicer.media/v1/upload-links/upl_…",
        headers={"Content-Type": "application/octet-stream"},
        data=file,
    )
body = response.json()

Ответ

Поля ответа: Upload (18)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`fileName`обязательное	`string`
`purpose`обязательное	`string`	`source` · `media` · `music`
`origin`обязательное	`string`	`client` · `import` · `server`
`sizeBytes`обязательное	`integer`
`status`обязательное	`string`	`uploading` · `processing` · `ready` · `failed` · `aborted`
`partSize`обязательное	`integer`	Размер части для `PUT …/parts/{n}`, байт (8 МиБ)
`partCount`обязательное	`integer`
`uploadedParts`обязательное	`integer[]`
`progress`обязательное	`number \| null`	Прогресс импорта 0–1 при загрузке по адресу0–1
`media`обязательное	`object \| null`
`media.kind`обязательное	`string`	`video` · `image` · `audio`
`media.durationSec`обязательное	`number`
`media.width`обязательное	`integer`
`media.height`обязательное	`integer`
`media.hasAudio`обязательное	`boolean`
`error`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

Пример ответа

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "fileName": "interview.mp4",
    "purpose": "source",
    "origin": "client",
    "sizeBytes": 104857600,
    "status": "uploading",
    "partSize": 104857600,
    "partCount": 13,
    "uploadedParts": [
      1
    ],
    "progress": 0.5,
    "media": {
      "kind": "video",
      "durationSec": 42.5,
      "width": 1,
      "height": 1,
      "hasAudio": true
    },
    "error": "string",
    "createdAt": "2026-10-16T09:30:00Z"
  }
}

Загрузить файл целиком

PUT/v1/uploads/{id}/content

Области доступа: projects:write
Лимит: обычный

Тело — байты файла, Content-Length равен заявленному размеру. Загрузка завершается сама.

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

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Тело запроса

Байты файла (application/octet-stream).

Запрос

curl

JavaScript

Python

curl -X PUT "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/content" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @video.mp4

import { readFile } from 'node:fs/promises';

const response = await fetch('https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/content', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/octet-stream',
  },
  body: await readFile('video.mp4'),
});
const { ok, data, error } = await response.json();

import os
import requests

with open("video.mp4", "rb") as file:
    response = requests.put(
        "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/content",
        headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}", "Content-Type": "application/octet-stream"},
        data=file,
    )
body = response.json()

Ответ

Поля ответа: Upload (18)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`fileName`обязательное	`string`
`purpose`обязательное	`string`	`source` · `media` · `music`
`origin`обязательное	`string`	`client` · `import` · `server`
`sizeBytes`обязательное	`integer`
`status`обязательное	`string`	`uploading` · `processing` · `ready` · `failed` · `aborted`
`partSize`обязательное	`integer`	Размер части для `PUT …/parts/{n}`, байт (8 МиБ)
`partCount`обязательное	`integer`
`uploadedParts`обязательное	`integer[]`
`progress`обязательное	`number \| null`	Прогресс импорта 0–1 при загрузке по адресу0–1
`media`обязательное	`object \| null`
`media.kind`обязательное	`string`	`video` · `image` · `audio`
`media.durationSec`обязательное	`number`
`media.width`обязательное	`integer`
`media.height`обязательное	`integer`
`media.hasAudio`обязательное	`boolean`
`error`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

Пример ответа

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "fileName": "interview.mp4",
    "purpose": "source",
    "origin": "client",
    "sizeBytes": 104857600,
    "status": "uploading",
    "partSize": 104857600,
    "partCount": 13,
    "uploadedParts": [
      1
    ],
    "progress": 0.5,
    "media": {
      "kind": "video",
      "durationSec": 42.5,
      "width": 1,
      "height": 1,
      "hasAudio": true
    },
    "error": "string",
    "createdAt": "2026-10-16T09:30:00Z"
  }
}

Загрузить часть

PUT/v1/uploads/{id}/parts/{n}

Области доступа: projects:write
Лимит: части загрузки

Части нумеруются с 1; все, кроме последней, — ровно partSize байт. Части можно слать параллельно и повторять.

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

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`n`обязательное	`integer`	≥ 1

Тело запроса

Байты файла (application/octet-stream).

Запрос

curl

JavaScript

Python

curl -X PUT "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/parts/1" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @video.mp4

import { readFile } from 'node:fs/promises';

const response = await fetch('https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/parts/1', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/octet-stream',
  },
  body: await readFile('video.mp4'),
});
const { ok, data, error } = await response.json();

import os
import requests

with open("video.mp4", "rb") as file:
    response = requests.put(
        "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/parts/1",
        headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}", "Content-Type": "application/octet-stream"},
        data=file,
    )
body = response.json()

Ответ

Поля ответа: object (2)

Поле	Тип	Описание
`part`обязательное	`integer`
`etag`обязательное	`string`

Пример ответа

{
  "ok": true,
  "data": {
    "part": 1,
    "etag": "string"
  }
}

Завершить загрузку по частям

POST/v1/uploads/{id}/complete

Области доступа: projects:write
Лимит: обычный

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

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/complete" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/complete', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20/complete",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: Upload (18)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`fileName`обязательное	`string`
`purpose`обязательное	`string`	`source` · `media` · `music`
`origin`обязательное	`string`	`client` · `import` · `server`
`sizeBytes`обязательное	`integer`
`status`обязательное	`string`	`uploading` · `processing` · `ready` · `failed` · `aborted`
`partSize`обязательное	`integer`	Размер части для `PUT …/parts/{n}`, байт (8 МиБ)
`partCount`обязательное	`integer`
`uploadedParts`обязательное	`integer[]`
`progress`обязательное	`number \| null`	Прогресс импорта 0–1 при загрузке по адресу0–1
`media`обязательное	`object \| null`
`media.kind`обязательное	`string`	`video` · `image` · `audio`
`media.durationSec`обязательное	`number`
`media.width`обязательное	`integer`
`media.height`обязательное	`integer`
`media.hasAudio`обязательное	`boolean`
`error`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

Пример ответа

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "fileName": "interview.mp4",
    "purpose": "source",
    "origin": "client",
    "sizeBytes": 104857600,
    "status": "uploading",
    "partSize": 104857600,
    "partCount": 13,
    "uploadedParts": [
      1
    ],
    "progress": 0.5,
    "media": {
      "kind": "video",
      "durationSec": 42.5,
      "width": 1,
      "height": 1,
      "hasAudio": true
    },
    "error": "string",
    "createdAt": "2026-10-16T09:30:00Z"
  }
}

Загрузить файл по адресу

POST/v1/uploads/import

Области доступа: projects:write
Лимит: обычный

Скачивает публичный https-файл в фоне. Опрашивайте GET /v1/uploads/{id} или ждите вебхук upload.ready.

Тело запроса `ImportUploadRequest`

Поле	Тип	Описание
`url`обязательное	`string (uri)`	Публичный https-адрес файла≤ 2048
`fileName`	`string`	Имя с расширением, если его нет в адресе≤ 255
`purpose`	`string`	`source` · `media` · `music`

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/uploads/import" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hook"}'

const response = await fetch('https://api.slicer.media/v1/uploads/import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "url": "https://example.com/hook"
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/uploads/import",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "url": "https://example.com/hook",
    },
)
body = response.json()

Ответ

Поля ответа: Upload (18)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`fileName`обязательное	`string`
`purpose`обязательное	`string`	`source` · `media` · `music`
`origin`обязательное	`string`	`client` · `import` · `server`
`sizeBytes`обязательное	`integer`
`status`обязательное	`string`	`uploading` · `processing` · `ready` · `failed` · `aborted`
`partSize`обязательное	`integer`	Размер части для `PUT …/parts/{n}`, байт (8 МиБ)
`partCount`обязательное	`integer`
`uploadedParts`обязательное	`integer[]`
`progress`обязательное	`number \| null`	Прогресс импорта 0–1 при загрузке по адресу0–1
`media`обязательное	`object \| null`
`media.kind`обязательное	`string`	`video` · `image` · `audio`
`media.durationSec`обязательное	`number`
`media.width`обязательное	`integer`
`media.height`обязательное	`integer`
`media.hasAudio`обязательное	`boolean`
`error`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

Пример ответа

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "fileName": "interview.mp4",
    "purpose": "source",
    "origin": "client",
    "sizeBytes": 104857600,
    "status": "uploading",
    "partSize": 104857600,
    "partCount": 13,
    "uploadedParts": [
      1
    ],
    "progress": 0.5,
    "media": {
      "kind": "video",
      "durationSec": 42.5,
      "width": 1,
      "height": 1,
      "hasAudio": true
    },
    "error": "string",
    "createdAt": "2026-10-16T09:30:00Z"
  }
}

Статус загрузки

GET/v1/uploads/{id}

Области доступа: projects:read
Лимит: обычный

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

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: Upload (18)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`fileName`обязательное	`string`
`purpose`обязательное	`string`	`source` · `media` · `music`
`origin`обязательное	`string`	`client` · `import` · `server`
`sizeBytes`обязательное	`integer`
`status`обязательное	`string`	`uploading` · `processing` · `ready` · `failed` · `aborted`
`partSize`обязательное	`integer`	Размер части для `PUT …/parts/{n}`, байт (8 МиБ)
`partCount`обязательное	`integer`
`uploadedParts`обязательное	`integer[]`
`progress`обязательное	`number \| null`	Прогресс импорта 0–1 при загрузке по адресу0–1
`media`обязательное	`object \| null`
`media.kind`обязательное	`string`	`video` · `image` · `audio`
`media.durationSec`обязательное	`number`
`media.width`обязательное	`integer`
`media.height`обязательное	`integer`
`media.hasAudio`обязательное	`boolean`
`error`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

Пример ответа

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "fileName": "interview.mp4",
    "purpose": "source",
    "origin": "client",
    "sizeBytes": 104857600,
    "status": "uploading",
    "partSize": 104857600,
    "partCount": 13,
    "uploadedParts": [
      1
    ],
    "progress": 0.5,
    "media": {
      "kind": "video",
      "durationSec": 42.5,
      "width": 1,
      "height": 1,
      "hasAudio": true
    },
    "error": "string",
    "createdAt": "2026-10-16T09:30:00Z"
  }
}

Отменить загрузку

DELETE/v1/uploads/{id}

Области доступа: projects:write
Лимит: обычный

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

Поле	Тип	Описание
`id`обязательное	`string (uuid)`

Запрос

curl

JavaScript

Python

curl -X DELETE "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.delete(
    "https://api.slicer.media/v1/uploads/6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

Поля ответа: object (2)

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`deleted`обязательное	`boolean`

Пример ответа

{
  "ok": true,
  "data": {
    "id": "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20",
    "deleted": true
  }
}

Схемы

Upload

Поле	Тип	Описание
`id`обязательное	`string (uuid)`
`fileName`обязательное	`string`
`purpose`обязательное	`string`	`source` · `media` · `music`
`origin`обязательное	`string`	`client` · `import` · `server`
`sizeBytes`обязательное	`integer`
`status`обязательное	`string`	`uploading` · `processing` · `ready` · `failed` · `aborted`
`partSize`обязательное	`integer`	Размер части для `PUT …/parts/{n}`, байт (8 МиБ)
`partCount`обязательное	`integer`
`uploadedParts`обязательное	`integer[]`
`progress`обязательное	`number \| null`	Прогресс импорта 0–1 при загрузке по адресу0–1
`media`обязательное	`object \| null`
`media.kind`обязательное	`string`	`video` · `image` · `audio`
`media.durationSec`обязательное	`number`
`media.width`обязательное	`integer`
`media.height`обязательное	`integer`
`media.hasAudio`обязательное	`boolean`
`error`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

CreatedUpload

Поле	Тип	Описание
`upload`обязательное	`Upload`
`uploadUrl`обязательное	`string (uri)`	Одноразовая ссылка: `PUT` всего файла без токена (≤ 1 ч, только запись)
`uploadUrlExpiresAt`обязательное	`string`	Дата и время ISO 8601, UTC

Начать загрузку#

Тело запроса CreateUploadRequest

Запрос

Ответ

Загрузить файл по одноразовой ссылке#

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

Тело запроса

Запрос

Ответ

Загрузить файл целиком#

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

Тело запроса

Запрос

Ответ

Загрузить часть#

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

Тело запроса

Запрос

Ответ

Завершить загрузку по частям#

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

Запрос

Ответ

Загрузить файл по адресу#

Тело запроса ImportUploadRequest

Запрос

Ответ

Статус загрузки#

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

Запрос

Ответ

Отменить загрузку#

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

Запрос

Ответ

Схемы#

Начать загрузку

Тело запроса `CreateUploadRequest`

Загрузить файл по одноразовой ссылке

Загрузить файл целиком

Загрузить часть

Завершить загрузку по частям

Загрузить файл по адресу

Тело запроса `ImportUploadRequest`

Статус загрузки

Отменить загрузку

Схемы