Projects

Slicer API project endpoints — starting a montage with price confirmation, status and stages, video versions, rebuild, retry, stop, history and downloads.

On this page

Create a project and start the montage
List projects
Project details
Rename a project
Delete a project and its files
Runs
Rebuild with new settings
Retry a failed run
Stop the run
Versions and history
Video versions
Choose a version
Project history
Files
Download the video
Download the cover (JPEG)
Schemas

A project is a video and everything that happened to it: materials, montage and export runs, versions, history. Paid operations (create with an AI montage, rebuild, retry) answer with a price first and start only with confirmCost — see Montage and pricing. A project without the AI director (mode: "manual") is created for free and without confirmation — see Project without the AI director.

Create a project and start the montage

POST/v1/projects

Scopes: projects:write
Rate limit: paid operations
Price: spends tokens

Without confirmCost returns a Quote and creates nothing. With confirmCost equal to the current price creates the project and starts the montage: one version that the director checks and fixes after rendering. The first video is free (cost: 0). With mode: "manual" the project is free: materials go to the timeline in order and the project becomes a draft — no confirmCost needed.

Request body `CreateProjectRequest`

Field	Type	Description
`uploadIds`required	`string (uuid)[]`	Ready `source` uploads in material order1–20
`mode`	`string`	`ai` (default) — the AI director edits the video, paid; `manual` — materials go to the timeline in order, the project is a free `draft` you edit and export yourself`ai` · `manual`
`format`	`string`	Frame format of a `manual` project (default 9:16)`9:16` · `4:5` · `1:1` · `16:9`
`settings`	`MontageSettingsInput`
`title`	`string`	≤ 120
`brief`	`string`	Wishes for the AI director≤ 600
`confirmCost`	`integer`	Price you agree to pay. Without it the response is a `Quote` and nothing starts

Request

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"uploadIds":["6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20"]}'

const response = await fetch('https://api.slicer.media/v1/projects', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "uploadIds": [
      "6f1c2a4e-8b3d-4c1a-9e2f-3b5d7a9c1e20"
    ]
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

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

Response

One of: Quote, ProjectDetails

Response fields: Quote (8)

Field	Type	Description
`status`required	`"quote"`
`cost`required	`integer`	Price in tokens; repeat the request with `confirmCost` equal to it. For an operation at cost (`atCost`) — the maximum: the actual cost is charged, never more
`free`required	`boolean`	The operation is free (first video, free retry)
`estimate`	`number`	Operation at cost: expected price in tokens (fractional)
`atCost`	`boolean`	Priced at the AI providers’ cost, no markup: the wallet is charged the actual cost, at most `cost`
`available`required	`integer`	Tokens available now
`enough`required	`boolean`	Enough tokens to run
`spendLimitLeft`required	`integer \| null`	What is left of the token's monthly spend limit; `null` — no limit

Response fields: ProjectDetails (44)

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`
`stages`required	`object[]`
`stages[].stage`required	`string`
`stages[].status`required	`string`	`pending` · `running` · `succeeded` · `failed` · `skipped`
`stages[].inRun`required	`boolean`	Part of the current run (not reused from a previous one)
`stages[].startedAt`required	`string \| null`
`stages[].finishedAt`required	`string \| null`
`stages[].durationSec`required	`number \| null`
`stages[].progress`required	`integer`
`stages[].tokens`required	`integer`	Share of the run price
`run`required	`object`
`run.kind`required	`string`
`run.status`required	`string`
`run.tokens`required	`integer`
`run.tokensState`required	`string`	`free` · `reserved` · `charged` · `refunded`
`run.queuedAt`required	`string`	ISO 8601 date-time, UTC
`run.startedAt`required	`string \| null`
`run.finishedAt`required	`string \| null`
`versions`required	`ProjectVersion[]`

Response example

{
  "ok": true,
  "data": {
    "status": "quote",
    "cost": 24,
    "free": true,
    "estimate": 1.5,
    "atCost": true,
    "available": 240,
    "enough": true,
    "spendLimitLeft": 200
  }
}

List projects

GET/v1/projects

Scopes: projects:read
Rate limit: default

Query parameters

Field	Type	Description
`limit`	`integer`	1–100
`cursor`	`string`	≤ 200
`status`	`string`	`all` · `ready` · `active` · `failed` · `draft`
`q`	`string`	≤ 100

Request

curl

JavaScript

Python

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

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

Response

Response fields: object (2)

Field	Type	Description
`items`required	`Project[]`
`nextCursor`required	`string \| null`

Response example

{
  "ok": true,
  "data": {
    "items": [
      {
        "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": null,
          "message": null
        },
        "durationSec": 42.5,
        "versionChoice": [
          null
        ],
        "result": {
          "url": null,
          "posterUrl": null,
          "container": null,
          "info": null
        },
        "appUrl": "https://api.slicer.media/v1/…",
        "sourcesAvailable": true,
        "createdAt": "2026-10-16T09:30:00Z",
        "finishedAt": "2026-10-16T09:30:00Z"
      }
    ],
    "nextCursor": "eyJpZCI6NDJ9"
  }
}

Project details

GET/v1/projects/{id}

Scopes: projects:read
Rate limit: default

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request

curl

JavaScript

Python

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

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

Response

Response fields: ProjectDetails (44)

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`
`stages`required	`object[]`
`stages[].stage`required	`string`
`stages[].status`required	`string`	`pending` · `running` · `succeeded` · `failed` · `skipped`
`stages[].inRun`required	`boolean`	Part of the current run (not reused from a previous one)
`stages[].startedAt`required	`string \| null`
`stages[].finishedAt`required	`string \| null`
`stages[].durationSec`required	`number \| null`
`stages[].progress`required	`integer`
`stages[].tokens`required	`integer`	Share of the run price
`run`required	`object`
`run.kind`required	`string`
`run.status`required	`string`
`run.tokens`required	`integer`
`run.tokensState`required	`string`	`free` · `reserved` · `charged` · `refunded`
`run.queuedAt`required	`string`	ISO 8601 date-time, UTC
`run.startedAt`required	`string \| null`
`run.finishedAt`required	`string \| null`
`versions`required	`ProjectVersion[]`

Response example

{
  "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"
      }
    ]
  }
}

Rename a project

PATCH/v1/projects/{id}

Scopes: projects:write
Rate limit: default

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request body `RenameRequest`

Field	Type	Description
`title`required	`string`	≤ 120

Request

curl

JavaScript

Python

curl -X PATCH "https://api.slicer.media/v1/projects/42" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Монтаж за 3 минуты"}'

const response = await fetch('https://api.slicer.media/v1/projects/42', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "title": "Монтаж за 3 минуты"
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.patch(
    "https://api.slicer.media/v1/projects/42",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "title": "Монтаж за 3 минуты",
    },
)
body = response.json()

Response

Response fields: Project (26)

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`

Response example

{
  "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"
  }
}

Delete a project and its files

DELETE/v1/projects/{id}

Scopes: projects:write
Rate limit: default

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request

curl

JavaScript

Python

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

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

Response

Response fields: object (2)

Field	Type	Description
`id`required	`integer`
`deleted`required	`boolean`

Response example

{
  "ok": true,
  "data": {
    "id": 42,
    "deleted": true
  }
}

Runs

Rebuild with new settings

POST/v1/projects/{id}/remount

Scopes: montage:run
Rate limit: paid operations
Price: spends tokens

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request body `RemountRequest`

Field	Type	Description
`settings`required	`MontageSettingsInput`
`brief`	`string`	≤ 600
`confirmCost`	`integer`	Price you agree to pay. Without it the response is a `Quote` and nothing starts

Request

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/remount" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"settings":{"templateId":"string","fontId":"string","colorId":"string","subtitles":{"enabled":true,"design":"dynamic","size":"small","position":"auto","speakerColors":true,"highlight":"auto","animation":"auto","words":"auto","letterCase":"auto"},"params":{"emoji":true,"soundEffects":true,"mediaCards":true,"plaques":true,"cameraMotion":true,"introZoom":true,"hook":true},"smartCut":true,"targetDurationSec":15,"language":"auto","direction":{"mode":"auto","pace":"calm","effects":"off","narration":true,"voice":"warm"}}}'

const response = await fetch('https://api.slicer.media/v1/projects/42/remount', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "settings": {
      "templateId": "string",
      "fontId": "string",
      "colorId": "string",
      "subtitles": {
        "enabled": true,
        "design": "dynamic",
        "size": "small",
        "position": "auto",
        "speakerColors": true,
        "highlight": "auto",
        "animation": "auto",
        "words": "auto",
        "letterCase": "auto"
      },
      "params": {
        "emoji": true,
        "soundEffects": true,
        "mediaCards": true,
        "plaques": true,
        "cameraMotion": true,
        "introZoom": true,
        "hook": true
      },
      "smartCut": true,
      "targetDurationSec": 15,
      "language": "auto",
      "direction": {
        "mode": "auto",
        "pace": "calm",
        "effects": "off",
        "narration": true,
        "voice": "warm"
      }
    }
  }),
});
const { ok, data, error } = await response.json();

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/remount",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={
        "settings": {
            "templateId": "string",
            "fontId": "string",
            "colorId": "string",
            "subtitles": {
                "enabled": True,
                "design": "dynamic",
                "size": "small",
                "position": "auto",
                "speakerColors": True,
                "highlight": "auto",
                "animation": "auto",
                "words": "auto",
                "letterCase": "auto",
            },
            "params": {
                "emoji": True,
                "soundEffects": True,
                "mediaCards": True,
                "plaques": True,
                "cameraMotion": True,
                "introZoom": True,
                "hook": True,
            },
            "smartCut": True,
            "targetDurationSec": 15,
            "language": "auto",
            "direction": {
                "mode": "auto",
                "pace": "calm",
                "effects": "off",
                "narration": True,
                "voice": "warm",
            },
        },
    },
)
body = response.json()

Response

One of: Quote, ProjectDetails

Response fields: Quote (8)

Field	Type	Description
`status`required	`"quote"`
`cost`required	`integer`	Price in tokens; repeat the request with `confirmCost` equal to it. For an operation at cost (`atCost`) — the maximum: the actual cost is charged, never more
`free`required	`boolean`	The operation is free (first video, free retry)
`estimate`	`number`	Operation at cost: expected price in tokens (fractional)
`atCost`	`boolean`	Priced at the AI providers’ cost, no markup: the wallet is charged the actual cost, at most `cost`
`available`required	`integer`	Tokens available now
`enough`required	`boolean`	Enough tokens to run
`spendLimitLeft`required	`integer \| null`	What is left of the token's monthly spend limit; `null` — no limit

Response fields: ProjectDetails (44)

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`
`stages`required	`object[]`
`stages[].stage`required	`string`
`stages[].status`required	`string`	`pending` · `running` · `succeeded` · `failed` · `skipped`
`stages[].inRun`required	`boolean`	Part of the current run (not reused from a previous one)
`stages[].startedAt`required	`string \| null`
`stages[].finishedAt`required	`string \| null`
`stages[].durationSec`required	`number \| null`
`stages[].progress`required	`integer`
`stages[].tokens`required	`integer`	Share of the run price
`run`required	`object`
`run.kind`required	`string`
`run.status`required	`string`
`run.tokens`required	`integer`
`run.tokensState`required	`string`	`free` · `reserved` · `charged` · `refunded`
`run.queuedAt`required	`string`	ISO 8601 date-time, UTC
`run.startedAt`required	`string \| null`
`run.finishedAt`required	`string \| null`
`versions`required	`ProjectVersion[]`

Response example

{
  "ok": true,
  "data": {
    "status": "quote",
    "cost": 24,
    "free": true,
    "estimate": 1.5,
    "atCost": true,
    "available": 240,
    "enough": true,
    "spendLimitLeft": 200
  }
}

Retry a failed run

POST/v1/projects/{id}/retry

Scopes: montage:run
Rate limit: paid operations
Price: spends tokens

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request body `RetryRequest`

Field	Type	Description
`confirmCost`	`integer`	Price you agree to pay. Without it the response is a `Quote` and nothing starts

Request

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/retry" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

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

import os
import requests

response = requests.post(
    "https://api.slicer.media/v1/projects/42/retry",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    json={},
)
body = response.json()

Response

One of: Quote, ProjectDetails

Response fields: Quote (8)

Field	Type	Description
`status`required	`"quote"`
`cost`required	`integer`	Price in tokens; repeat the request with `confirmCost` equal to it. For an operation at cost (`atCost`) — the maximum: the actual cost is charged, never more
`free`required	`boolean`	The operation is free (first video, free retry)
`estimate`	`number`	Operation at cost: expected price in tokens (fractional)
`atCost`	`boolean`	Priced at the AI providers’ cost, no markup: the wallet is charged the actual cost, at most `cost`
`available`required	`integer`	Tokens available now
`enough`required	`boolean`	Enough tokens to run
`spendLimitLeft`required	`integer \| null`	What is left of the token's monthly spend limit; `null` — no limit

Response fields: ProjectDetails (44)

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`
`stages`required	`object[]`
`stages[].stage`required	`string`
`stages[].status`required	`string`	`pending` · `running` · `succeeded` · `failed` · `skipped`
`stages[].inRun`required	`boolean`	Part of the current run (not reused from a previous one)
`stages[].startedAt`required	`string \| null`
`stages[].finishedAt`required	`string \| null`
`stages[].durationSec`required	`number \| null`
`stages[].progress`required	`integer`
`stages[].tokens`required	`integer`	Share of the run price
`run`required	`object`
`run.kind`required	`string`
`run.status`required	`string`
`run.tokens`required	`integer`
`run.tokensState`required	`string`	`free` · `reserved` · `charged` · `refunded`
`run.queuedAt`required	`string`	ISO 8601 date-time, UTC
`run.startedAt`required	`string \| null`
`run.finishedAt`required	`string \| null`
`versions`required	`ProjectVersion[]`

Response example

{
  "ok": true,
  "data": {
    "status": "quote",
    "cost": 24,
    "free": true,
    "estimate": 1.5,
    "atCost": true,
    "available": 240,
    "enough": true,
    "spendLimitLeft": 200
  }
}

Stop the run

POST/v1/projects/{id}/cancel

Scopes: projects:write
Rate limit: default

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request

curl

JavaScript

Python

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

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

Response

Response fields: ProjectDetails (44)

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`
`stages`required	`object[]`
`stages[].stage`required	`string`
`stages[].status`required	`string`	`pending` · `running` · `succeeded` · `failed` · `skipped`
`stages[].inRun`required	`boolean`	Part of the current run (not reused from a previous one)
`stages[].startedAt`required	`string \| null`
`stages[].finishedAt`required	`string \| null`
`stages[].durationSec`required	`number \| null`
`stages[].progress`required	`integer`
`stages[].tokens`required	`integer`	Share of the run price
`run`required	`object`
`run.kind`required	`string`
`run.status`required	`string`
`run.tokens`required	`integer`
`run.tokensState`required	`string`	`free` · `reserved` · `charged` · `refunded`
`run.queuedAt`required	`string`	ISO 8601 date-time, UTC
`run.startedAt`required	`string \| null`
`run.finishedAt`required	`string \| null`
`versions`required	`ProjectVersion[]`

Response example

{
  "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"
      }
    ]
  }
}

Versions and history

Video versions

GET/v1/projects/{id}/versions

Scopes: projects:read
Rate limit: default

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request

curl

JavaScript

Python

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

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

Response

Response example

{
  "ok": true,
  "data": [
    {
      "id": 42,
      "version": 1,
      "idea": "string",
      "durationSec": 42.5,
      "current": true,
      "awaitingChoice": true,
      "hasFile": true,
      "createdAt": "2026-10-16T09:30:00Z"
    }
  ]
}

Choose a version

POST/v1/projects/{id}/versions/{versionId}/choose

Scopes: projects:write
Rate limit: default

Makes a version current: one awaiting choice (versionChoice) or any version from the history whose file is kept (hasFile) — like «Make current» in the app. The previous video stays in the history.

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1
`versionId`required	`integer`	≥ 1

Request

curl

JavaScript

Python

curl -X POST "https://api.slicer.media/v1/projects/42/versions/42/choose" \
  -H "Authorization: Bearer $SLICER_TOKEN"

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

Response

Response fields: ProjectDetails (44)

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`
`stages`required	`object[]`
`stages[].stage`required	`string`
`stages[].status`required	`string`	`pending` · `running` · `succeeded` · `failed` · `skipped`
`stages[].inRun`required	`boolean`	Part of the current run (not reused from a previous one)
`stages[].startedAt`required	`string \| null`
`stages[].finishedAt`required	`string \| null`
`stages[].durationSec`required	`number \| null`
`stages[].progress`required	`integer`
`stages[].tokens`required	`integer`	Share of the run price
`run`required	`object`
`run.kind`required	`string`
`run.status`required	`string`
`run.tokens`required	`integer`
`run.tokensState`required	`string`	`free` · `reserved` · `charged` · `refunded`
`run.queuedAt`required	`string`	ISO 8601 date-time, UTC
`run.startedAt`required	`string \| null`
`run.finishedAt`required	`string \| null`
`versions`required	`ProjectVersion[]`

Response example

{
  "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"
      }
    ]
  }
}

Project history

GET/v1/projects/{id}/history

Scopes: projects:read
Rate limit: default

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request

curl

JavaScript

Python

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

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

Response

Response example

{
  "ok": true,
  "data": [
    {
      "id": 42,
      "kind": "string",
      "status": "string",
      "title": "Монтаж за 3 минуты",
      "version": 1,
      "createdAt": "2026-10-16T09:30:00Z"
    }
  ]
}

Files

Download the video

GET/v1/projects/{id}/result

Scopes: projects:read
Rate limit: default

Range requests are supported. ?version={versionId} — a kept version file.

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Query parameters

Field	Type	Description
`version`	`integer`	≥ 1

Request

curl

JavaScript

Python

curl "https://api.slicer.media/v1/projects/42/result" \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -o video.mp4

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

const response = await fetch('https://api.slicer.media/v1/projects/42/result', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
await writeFile('video.mp4', Buffer.from(await response.arrayBuffer()));

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/projects/42/result",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    stream=True,
)
with open("video.mp4", "wb") as out:
    for chunk in response.iter_content(chunk_size=1 << 20):
        out.write(chunk)

Response

A file (application/octet-stream); Range requests are supported.

Download the cover (JPEG)

GET/v1/projects/{id}/poster

Scopes: projects:read
Rate limit: default

Path parameters

Field	Type	Description
`id`required	`integer`	≥ 1

Request

curl

JavaScript

Python

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

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

const response = await fetch('https://api.slicer.media/v1/projects/42/poster', {
  headers: {
    Authorization: `Bearer ${process.env.SLICER_TOKEN}`,
  },
});
await writeFile('poster.jpg', Buffer.from(await response.arrayBuffer()));

import os
import requests

response = requests.get(
    "https://api.slicer.media/v1/projects/42/poster",
    headers={"Authorization": f"Bearer {os.environ['SLICER_TOKEN']}"},
    stream=True,
)
with open("poster.jpg", "wb") as out:
    for chunk in response.iter_content(chunk_size=1 << 20):
        out.write(chunk)

Response

A file (application/octet-stream); Range requests are supported.

Schemas

Project

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`

ProjectDetails

Field	Type	Description
`id`required	`integer`
`title`required	`string`
`status`required	`string`	`draft` — an “edit it myself” project before its first export: edit it with operations, then export`queued` · `processing` · `succeeded` · `failed` · `cancelled` · `draft`
`mode`required	`string`	`ai` — edited by the AI director; `manual` — materials on the timeline as is, free (only AI operations cost)`ai` · `manual`
`stage`required	`string \| null`
`progress`required	`integer`	Progress of the current run, %
`client`required	`string \| null`	Where it was created: web, mobile, api, mcp
`settings`required	`object`	Montage settings (see MontageSettingsInput)
`brief`required	`string \| null`
`isFree`required	`boolean`
`watermark`required	`boolean`
`tokensCost`required	`integer`
`error`required	`object \| null`
`error.code`required	`string`
`error.message`required	`string`
`durationSec`required	`number \| null`
`versionChoice`required	`integer[] \| null`	Version ids awaiting your choice; a montage returns one version, so usually `null`
`result`required	`object \| null`
`result.url`required	`string (uri)`	Download with the token (Range supported)
`result.posterUrl`required	`string (uri) \| null`
`result.container`required	`string`
`result.info`required	`object \| null`
`appUrl`required	`string (uri)`	The project in the Slicer web app
`sourcesAvailable`required	`boolean`	Sources are kept 7 days after the montage
`createdAt`required	`string`	ISO 8601 date-time, UTC
`finishedAt`required	`string \| null`
`stages`required	`object[]`
`stages[].stage`required	`string`
`stages[].status`required	`string`	`pending` · `running` · `succeeded` · `failed` · `skipped`
`stages[].inRun`required	`boolean`	Part of the current run (not reused from a previous one)
`stages[].startedAt`required	`string \| null`
`stages[].finishedAt`required	`string \| null`
`stages[].durationSec`required	`number \| null`
`stages[].progress`required	`integer`
`stages[].tokens`required	`integer`	Share of the run price
`run`required	`object`
`run.kind`required	`string`
`run.status`required	`string`
`run.tokens`required	`integer`
`run.tokensState`required	`string`	`free` · `reserved` · `charged` · `refunded`
`run.queuedAt`required	`string`	ISO 8601 date-time, UTC
`run.startedAt`required	`string \| null`
`run.finishedAt`required	`string \| null`
`versions`required	`ProjectVersion[]`

ProjectVersion

Field	Type	Description
`id`required	`integer`	Version id (history event)
`version`required	`integer \| null`
`idea`required	`string \| null`	What makes this version different
`durationSec`required	`number \| null`
`current`required	`boolean`
`awaitingChoice`required	`boolean`	Offered for choice after the last montage
`hasFile`required	`boolean`	The file is kept (last 10 versions)
`createdAt`required	`string`	ISO 8601 date-time, UTC

CreateProjectRequest

Field	Type	Description
`uploadIds`required	`string (uuid)[]`	Ready `source` uploads in material order1–20
`mode`	`string`	`ai` (default) — the AI director edits the video, paid; `manual` — materials go to the timeline in order, the project is a free `draft` you edit and export yourself`ai` · `manual`
`format`	`string`	Frame format of a `manual` project (default 9:16)`9:16` · `4:5` · `1:1` · `16:9`
`settings`	`MontageSettingsInput`
`title`	`string`	≤ 120
`brief`	`string`	Wishes for the AI director≤ 600
`confirmCost`	`integer`	Price you agree to pay. Without it the response is a `Quote` and nothing starts

HistoryEvent

Field	Type	Description
`id`required	`integer`
`kind`required	`string`
`status`required	`string`
`title`required	`string \| null`
`version`required	`integer \| null`
`createdAt`required	`string`	ISO 8601 date-time, UTC

Create a project and start the montage#

Request body CreateProjectRequest

Request

Response

List projects#

Query parameters

Request

Response

Project details#

Path parameters

Request

Response

Rename a project#

Path parameters

Request body RenameRequest

Request

Response

Delete a project and its files#

Path parameters

Request

Response

Runs#

Rebuild with new settings#

Path parameters

Request body RemountRequest

Request

Response

Retry a failed run#

Path parameters

Request body RetryRequest

Request

Response

Stop the run#

Path parameters

Request

Response

Versions and history#

Video versions#

Path parameters

Request

Response

Choose a version#

Path parameters

Request

Response

Project history#

Path parameters

Request

Response

Files#

Download the video#

Path parameters

Query parameters

Request

Response

Download the cover (JPEG)#

Path parameters

Request

Response

Schemas#

Create a project and start the montage

Request body `CreateProjectRequest`

List projects

Project details

Rename a project

Request body `RenameRequest`

Delete a project and its files

Runs

Rebuild with new settings

Request body `RemountRequest`

Retry a failed run

Request body `RetryRequest`

Stop the run

Versions and history

Video versions

Choose a version

Project history

Files

Download the video

Download the cover (JPEG)

Schemas