# Slicer API

> Публичное REST API Slicer — всё, что вы делаете в приложении, можно делать программно по API-токену — загрузка, монтаж, правки, экспорт.

Источник: https://docs.slicer.media/api/

Slicer API — это публичное REST API версии 1 (`/v1`). Через него ваш код делает то же, что вы делаете в приложении: загружает видео, фото и аудио, запускает ИИ-монтаж, выбирает версию ролика, правит субтитры и элементы, экспортирует ролик и публикует его в подключённые соцсети. API подходит для автоматизации («ролик из каждой новой записи»), своих интеграций и сервисов поверх Slicer.

Если вы работаете с ИИ-агентом (Claude, Cursor, VS Code, Codex, ChatGPT), удобнее подключить [MCP-сервер](https://docs.slicer.media/mcp/) — он даёт агенту те же возможности без кода.

## Базовые сведения

| Что | Значение |
| --- | --- |
| Базовый адрес | `https://api.slicer.media/v1` |
| Вход | `Authorization: Bearer <токен>` — [API-токен](https://docs.slicer.media/api/authentication/) из профиля или токен доступа OAuth |
| Формат | JSON, поля в `camelCase`, время — ISO 8601 в UTC, длительность — секунды, цены — целые токены (ожидаемая цена операций по себестоимости — дробная) |
| Ответ | `{ "ok": true, "data": … }` или `{ "ok": false, "error": { "code", "message" } }` |
| Спецификация | [`GET /v1/openapi.json`](https://api.slicer.media/v1/openapi.json) — OpenAPI 3.1, без входа |
| Версия | 1.3.0, изменения внутри v1 только добавляющие — [Версии и совместимость](https://docs.slicer.media/api/versioning/#history) |

Первый запрос — проверить токен и баланс:

Терминал:

```bash
curl https://api.slicer.media/v1/me \
  -H "Authorization: Bearer $SLICER_TOKEN"
```

Ответ:

```json
{
  "ok": true,
  "data": {
    "id": 1042,
    "name": "Анна",
    "language": "ru",
    "wallet": { "balance": 240, "held": 0, "available": 240, "freeMontageAvailable": false, "montageTokens": 24 },
    "token": { "kind": "personal", "scopes": ["account:read", "projects:read", "projects:write", "montage:run"], "spendLimit": 200, "spentThisMonth": 0 }
  }
}
```

## Как устроена работа

Типичный путь ролика через API:

### 1. Загрузить материалы

`POST /v1/uploads` создаёт загрузку и отдаёт одноразовую ссылку `uploadUrl`, на которую файл отправляется одной командой `curl -T`. Можно и по частям, и по публичному адресу — [Загрузка файлов](https://docs.slicer.media/api/uploads/).

### 2. Узнать цену и запустить монтаж

`POST /v1/projects` без `confirmCost` возвращает цену и ничего не запускает. Повторите запрос с `confirmCost`, равным цене, — проект создан, монтаж идёт. Деньги без явного согласия не тратятся — [Монтаж и цена](https://docs.slicer.media/api/montage/). Собрать ролик самому можно в бесплатном [проекте без ИИ-режиссёра](https://docs.slicer.media/api/montage/#manual) (`mode: "manual"`).

### 3. Дождаться результата

Опрашивайте `GET /v1/projects/{id}` раз в 5 секунд или подпишитесь на [вебхуки](https://docs.slicer.media/api/webhooks/). Монтаж отдаёт две версии ролика — выберите лучшую.

### 4. Поправить и экспортировать

Правки ролика — операциями по словам транскрипта или по времени ролика, бесплатно ([Правки ролика](https://docs.slicer.media/api/editing/)). Экспорт перерисовывает ролик и при желании публикует его в соцсети ([Экспорт и публикация](https://docs.slicer.media/api/export/)).

### 5. Скачать

`GET /v1/projects/{id}/result` отдаёт файл ролика по токену; проект также открывается в веб-приложении по ссылке `appUrl`.

Весь путь целиком, с готовым кодом на curl, JavaScript и Python, — в [Быстром старте](https://docs.slicer.media/api/quickstart/).

## Что тратит токены

Платные операции — монтаж, пересборка, повтор, субтитры из речи, ИИ-помощник и перевод субтитров. Каждая из них сначала отвечает ценой (`Quote`) и запускается только с `confirmCost`. Субтитры из речи, ИИ-помощник и перевод стоят по себестоимости ИИ без наценки: в цене — ожидаемая сумма и предельная, списывается фактическая, не больше предельной. Дополнительно токен можно ограничить [лимитом расходов](https://docs.slicer.media/api/authentication/) в месяц и областями доступа: без области `montage:run` токен не может потратить ничего. Правки, смена стиля, выбор версии, экспорт и проект без ИИ-режиссёра — бесплатны.

## Что пока доступно только в приложении

В версии 1.7 через API нельзя: купить пакет токенов, подключить соцсеть (нужен браузер владельца аккаунта), удалить фон, отделить голос, сделать ИИ-аватар и ИИ-эффект, добавить файлы в медиа уже созданного проекта, поговорить с режиссёром в [«Чате»](https://docs.slicer.media/guide/ai/chat/). Эти функции появятся в следующих минорных версиях v1 — следите за [журналом изменений](https://docs.slicer.media/changelog/).

## Безопасность

Токен даёт доступ к вашему аккаунту — храните его как пароль: в переменной окружения или менеджере секретов, не в коде и не в браузере. В базе Slicer хранится только хэш токена, отозвать его можно в любой момент. Подробно о защите сервиса и данных — на странице [Безопасность](https://docs.slicer.media/security/).

## Что дальше

[Быстрый стартПервый ролик через API за 10 минут: curl, JavaScript, Python.](https://docs.slicer.media/api/quickstart/)[Токены и области доступаКак создать токен, выбрать доступ, срок и лимит расходов.](https://docs.slicer.media/api/authentication/)[СправочникВсе эндпоинты v1 с параметрами, ответами и примерами.](https://docs.slicer.media/api/reference/)[MCP-серверТе же возможности для ИИ-агентов — без кода.](https://docs.slicer.media/mcp/)