Справочник API
Все эндпоинты Slicer API v1 по группам — метод, путь, области доступа, лимит, цена, параметры, ответы и примеры на curl, JavaScript и Python.
На этой странице
Справочник строится из спецификации OpenAPI 3.1, которую отдаёт сам сервер, — описание и поведение API не расходятся.
Скачать спецификацию для генератора клиентов или Postman можно без токена:
https://api.slicer.media/v1/openapi.json (откроется в новой вкладке).
Группы
| Группа | Что внутри |
|---|---|
| Аккаунт | профиль, баланс, токен, операции кошелька |
| Каталог и цены | стили и настройки монтажа, пресеты экспорта, цена операции, спецификация |
| Загрузки | загрузка файлов целиком, по частям, по ссылке и по адресу |
| Проекты | монтаж, статус, версии, пересборка, повтор, остановка, скачивание |
| Правки | текст ролика, операции правок, документ монтажа, ИИ-помощник, перевод, стиль |
| Экспорт и публикация | рендер ролика, публикации, подключённые соцсети |
| Вебхуки | адреса уведомлений, проверка и журнал доставок |
Как читать описание эндпоинта
- Метод и путь — относительно
https://api.slicer.media; параметры пути — в фигурных скобках. - Области — какие области доступа нужны токену. «Любая» — достаточно любого действующего токена.
- Лимит — корзина лимита запросов: обычные, платные или части загрузки.
- Цена — у платных эндпоинтов: без
confirmCostответ — ценаQuote, ничего не запускается (Монтаж и цена). У субтитров из речи, ИИ-помощника и перевода цена — себестоимость ИИ: вQuoteестьestimate(ожидаемая) иatCost: true, аcost— предельная цена (Правки ролика). - Ответ — содержимое поля
dataуспешного ответа{ "ok": true, "data": … }. Ошибки — в общем формате (Ошибки).
Все запросы с телом отправляют JSON (Content-Type: application/json), кроме загрузки файлов — там тело —
байты файла (application/octet-stream).
Общие схемы
Quote
| Поле | Тип | Описание |
|---|---|---|
statusобязательное | "quote" | |
costобязательное | integer | Цена в токенах; повторите запрос с confirmCost, равным ей. У операции по себестоимости (atCost) — предельная: спишется фактическая себестоимость, не больше |
freeобязательное | boolean | Операция бесплатна (первый ролик, бесплатный повтор) |
estimate | number | Операция по себестоимости: ожидаемая цена в токенах (дробно) |
atCost | boolean | Цена — себестоимость ИИ-сервисов без наценки: списывается фактическая, не больше cost |
availableобязательное | integer | Сколько токенов доступно сейчас |
enoughобязательное | boolean | Токенов хватает |
spendLimitLeftобязательное | integer | null | Остаток месячного лимита расходов токена; null — без лимита |
Error
| Поле | Тип | Описание |
|---|---|---|
okобязательное | false | |
errorобязательное | object | |
error.codeобязательное | string | Стабильный код ошибки в snake_case |
error.messageобязательное | string | Понятный текст на языке аккаунта |
error.fields | Record<string, string> | Ошибки по полям |
error.retryAfterSec | integer | Через сколько секунд повторить |