Экспорт и публикация

Эндпоинты экспорта Slicer API — рендер ролика с параметрами файла и публикацией, список публикаций проекта и подключённые аккаунты соцсетей.

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

Отрендерить ролик (бесплатно)
Публикации проекта
Подключённые соцсети
Схемы

Экспорт бесплатный и перерисовывает ролик по текущему документу. С полем publish ролик после рендера публикуется в подключённые аккаунты — для этого токену нужна область publish. Подключать соцсети можно только в приложении, TikTok — публиковать только из приложения. Подробно — Экспорт и публикация.

Отрендерить ролик (бесплатно)

POST/v1/projects/{id}/export

Области доступа: projects:write
Лимит: платные операции

С publish — публикует после рендера (нужна область publish). TikTok — только из приложения Slicer.

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

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

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

Поле	Тип	Описание
`profile`	`ExportProfile`
`publish`	`PublishRequestItem[]`	0–8

Запрос

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/export" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile":{"container":"mp4","codec":"h264","resolution":"720p","fps":24,"quality":"balanced","colorDepth":8,"audioBitrate":128,"loudness":-14},"publish":[{"accountId":42,"title":"Монтаж за 3 минуты","caption":"string","options":{}}]}'

const response = await fetch('https://api.slicer.media/v1/projects/42/export', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "profile": {
      "container": "mp4",
      "codec": "h264",
      "resolution": "720p",
      "fps": 24,
      "quality": "balanced",
      "colorDepth": 8,
      "audioBitrate": 128,
      "loudness": -14
    },
    "publish": [
      {
        "accountId": 42,
        "title": "Монтаж за 3 минуты",
        "caption": "string",
        "options": {}
      }
    ]
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/export",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "profile": {
            "container": "mp4",
            "codec": "h264",
            "resolution": "720p",
            "fps": 24,
            "quality": "balanced",
            "colorDepth": 8,
            "audioBitrate": 128,
            "loudness": -14,
        },
        "publish": [{
            "accountId": 42,
            "title": "Монтаж за 3 минуты",
            "caption": "string",
            "options": {},
        }],
    },
)
body = response.json()

Ответ

Поля ответа: ProjectDetails (44)

Поле	Тип	Описание
`id`обязательное	`integer`
`title`обязательное	`string`
`status`обязательное	`string`	`draft` — проект «Сам в редакторе» до первого экспорта: правьте операциями и экспортируйте`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`обязательное	`string`	`ai` — монтаж ИИ-режиссёром; `manual` — материалы на таймлайне как есть, бесплатно (платны только ИИ-операции)`ai` · `manual`
`stage`обязательное	`string \| null`
`progress`обязательное	`integer`	Прогресс текущего запуска, %
`client`обязательное	`string \| null`	Где создан: web, mobile, api, mcp
`settings`обязательное	`object`	Настройки монтажа (см. MontageSettingsInput)
`brief`обязательное	`string \| null`
`isFree`обязательное	`boolean`
`watermark`обязательное	`boolean`
`tokensCost`обязательное	`integer`
`error`обязательное	`object \| null`
`error.code`обязательное	`string`
`error.message`обязательное	`string`
`durationSec`обязательное	`number \| null`
`versionChoice`обязательное	`integer[] \| null`	Id версий, ждущих выбора; монтаж отдаёт одну версию, поэтому обычно `null`
`result`обязательное	`object \| null`
`result.url`обязательное	`string (uri)`	Скачать с токеном (поддерживается Range)
`result.posterUrl`обязательное	`string (uri) \| null`
`result.container`обязательное	`string`
`result.info`обязательное	`object \| null`
`appUrl`обязательное	`string (uri)`	Проект в веб-приложении Slicer
`sourcesAvailable`обязательное	`boolean`	Исходники хранятся 7 дней после монтажа
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC
`finishedAt`обязательное	`string \| null`
`stages`обязательное	`object[]`
`stages[].stage`обязательное	`string`
`stages[].status`обязательное	`string`	`pending` · `running` · `succeeded` · `failed` · `skipped`
`stages[].inRun`обязательное	`boolean`	Часть текущего запуска (не взят готовым)
`stages[].startedAt`обязательное	`string \| null`
`stages[].finishedAt`обязательное	`string \| null`
`stages[].durationSec`обязательное	`number \| null`
`stages[].progress`обязательное	`integer`
`stages[].tokens`обязательное	`integer`	Доля цены запуска
`run`обязательное	`object`
`run.kind`обязательное	`string`
`run.status`обязательное	`string`
`run.tokens`обязательное	`integer`
`run.tokensState`обязательное	`string`	`free` · `reserved` · `charged` · `refunded`
`run.queuedAt`обязательное	`string`	Дата и время ISO 8601, UTC
`run.startedAt`обязательное	`string \| null`
`run.finishedAt`обязательное	`string \| null`
`versions`обязательное	`ProjectVersion[]`

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

{
  "ok": true,
  "data": {
    "id": 42,
    "title": "Монтаж за 3 минуты",
    "status": "queued",
    "mode": "ai",
    "stage": "string",
    "progress": 0.5,
    "client": "string",
    "settings": {},
    "brief": "Динамично, с акцентом на главные мысли",
    "isFree": true,
    "watermark": true,
    "tokensCost": 24,
    "error": {
      "code": "string",
      "message": "string"
    },
    "durationSec": 42.5,
    "versionChoice": [
      1
    ],
    "result": {
      "url": "https://example.com/hook",
      "posterUrl": "https://api.slicer.media/v1/…",
      "container": "string",
      "info": {}
    },
    "appUrl": "https://api.slicer.media/v1/…",
    "sourcesAvailable": true,
    "createdAt": "2026-10-16T09:30:00Z",
    "finishedAt": "2026-10-16T09:30:00Z",
    "stages": [
      {
        "stage": "string",
        "status": "pending",
        "inRun": true,
        "startedAt": "2026-10-16T09:30:00Z",
        "finishedAt": "2026-10-16T09:30:00Z",
        "durationSec": 42.5,
        "progress": 0.5,
        "tokens": 24
      }
    ],
    "run": {
      "kind": "string",
      "status": "string",
      "tokens": 24,
      "tokensState": "free",
      "queuedAt": "2026-10-16T09:30:00Z",
      "startedAt": "2026-10-16T09:30:00Z",
      "finishedAt": "2026-10-16T09:30:00Z"
    },
    "versions": [
      {
        "id": 42,
        "version": null,
        "idea": "string",
        "durationSec": 42.5,
        "current": true,
        "awaitingChoice": true,
        "hasFile": true,
        "createdAt": "2026-10-16T09:30:00Z"
      }
    ]
  }
}

Публикации проекта

GET/v1/projects/{id}/publications

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

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

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

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/projects/42/publications" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/projects/42/publications', {
  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/projects/42/publications",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

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

{
  "ok": true,
  "data": [
    {
      "id": 42,
      "platform": "string",
      "accountName": "Anna",
      "status": "string",
      "url": "https://example.com/hook",
      "errorCode": "string",
      "createdAt": "2026-10-16T09:30:00Z"
    }
  ]
}

Подключённые соцсети

GET/v1/social/accounts

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

Запрос

curl

JavaScript

Python

curl "https://api.slicer.media/v1/social/accounts" \
  -H "Authorization: Bearer $SLICER_TOKEN"

const response = await fetch('https://api.slicer.media/v1/social/accounts', {
  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/social/accounts",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
)
body = response.json()

Ответ

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

{
  "ok": true,
  "data": [
    {
      "id": 42,
      "platform": "youtube",
      "name": "Anna",
      "status": "string",
      "apiPublishing": true
    }
  ]
}

Схемы

ExportRequest

Поле	Тип	Описание
`profile`	`ExportProfile`
`publish`	`PublishRequestItem[]`	0–8

ExportProfile

Поле	Тип	Описание
`container`	`string`	`mp4` · `mov`
`codec`	`string`	`h264` · `hevc`
`resolution`	`string`	`720p` · `1080p` · `1440p` · `2160p`
`fps`	`24 \| 25 \| 30`
`quality`	`string`	`balanced` · `high` · `max`
`colorDepth`	`8 \| 10`	10 бит — только с HEVC
`audioBitrate`	`128 \| 192 \| 256 \| 320`
`loudness`	`-14 \| -16 \| -23`	Громкость, LUFS

PublishRequestItem

Поле	Тип	Описание
`accountId`обязательное	`integer`	Подключённый аккаунт из GET /v1/social/accounts
`title`	`string`	≤ 150
`caption`	`string`	≤ 5000
`options`	`object`	Настройки платформы: `{ youtube: { privacy, madeForKids } }`, `{ instagram: { shareToFeed } }`, `{ vk: { privacy, wallpost, groupId } }`, `aiGenerated`

Publication

Поле	Тип	Описание
`id`обязательное	`integer`
`platform`обязательное	`string`
`accountName`обязательное	`string \| null`
`status`обязательное	`string`
`url`обязательное	`string \| null`
`errorCode`обязательное	`string \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

SocialAccount

Поле	Тип	Описание
`id`обязательное	`integer`
`platform`обязательное	`string`	`youtube` · `instagram` · `tiktok` · `vk`
`name`обязательное	`string \| null`
`status`обязательное	`string`
`apiPublishing`обязательное	`boolean`	Можно публиковать через API (TikTok — только из приложения)

Отрендерить ролик (бесплатно)#

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

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

Запрос

Ответ

Публикации проекта#

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

Запрос

Ответ

Подключённые соцсети#

Запрос

Ответ

Схемы#

Отрендерить ролик (бесплатно)

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

Публикации проекта

Подключённые соцсети

Схемы