Перейти к содержанию
БезопасностьENОткрыть Slicer

Slicer API

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

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

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

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

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

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

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

Терминал
curl https://api.slicer.media/v1/me \
  -H "Authorization: Bearer $SLICER_TOKEN"
Ответ
{
  "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. Можно и по частям, и по публичному адресу — Загрузка файлов.

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

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

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

    Опрашивайте GET /v1/projects/{id} раз в 5 секунд или подпишитесь на вебхуки. Монтаж отдаёт две версии ролика — выберите лучшую.

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

    Правки ролика — операциями по словам транскрипта или по времени ролика, бесплатно (Правки ролика). Экспорт перерисовывает ролик и при желании публикует его в соцсети (Экспорт и публикация).

  5. Скачать

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

Весь путь целиком, с готовым кодом на curl, JavaScript и Python, — в Быстром старте.

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

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

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

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

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

Токен даёт доступ к вашему аккаунту — храните его как пароль: в переменной окружения или менеджере секретов, не в коде и не в браузере. В базе Slicer хранится только хэш токена, отозвать его можно в любой момент. Подробно о защите сервиса и данных — на странице Безопасность.

Что дальше

Быстрый стартПервый ролик через API за 10 минут: curl, JavaScript, Python.Токены и области доступаКак создать токен, выбрать доступ, срок и лимит расходов.СправочникВсе эндпоинты v1 с параметрами, ответами и примерами.MCP-серверТе же возможности для ИИ-агентов — без кода.