Catalog and prices

The catalog of styles and montage settings, export presets, operation prices before starting and the OpenAPI spec — endpoints open to any token.

On this page

Styles, settings and prices
Export presets and the default profile
Price of an operation
This specification (OpenAPI 3.1)
Schemas

The catalog is the same one the Slicer apps use: templates, fonts, accent colors, caption designs, montage settings, direction, durations, material limits and prices. Titles and descriptions come in Russian and English. The catalog rarely changes and is worth caching.

Styles, settings and prices

GET/v1/styles

Scopes: any token
Rate limit: default

Request

curl

JavaScript

Python

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

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

Response

Response fields: Styles (15)

Field	Type	Description
`templates`required	`object[]`
`templates[].id`required	`string`
`fonts`required	`object[]`
`fonts[].id`required	`string`
`colors`required	`object[]`
`colors[].id`required	`string`
`subtitleDesigns`required	`object[]`
`subtitleDesigns[].id`required	`string`
`subtitleOptions`	`object[]`	Caption options (word highlight, entrance, words on screen, letter case) with their values
`subtitleOptions[].id`required	`string`
`params`required	`object[]`
`params[].id`required	`string`
`direction`required	`object`
`defaults`required	`object`
`pricing`required	`object`

Response example

{
  "ok": true,
  "data": {
    "templates": [
      {
        "id": "string"
      }
    ],
    "fonts": [
      {
        "id": "string"
      }
    ],
    "colors": [
      {
        "id": "string"
      }
    ],
    "subtitleDesigns": [
      {
        "id": "string"
      }
    ],
    "subtitleOptions": [
      {
        "id": "string"
      }
    ],
    "params": [
      {
        "id": "string"
      }
    ],
    "direction": {},
    "defaults": {},
    "pricing": {}
  }
}

Export presets and the default profile

GET/v1/export-presets

Scopes: any token
Rate limit: default

Request

curl

JavaScript

Python

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

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

Response

Response fields: object (4)

Field	Type	Description
`defaultProfile`required	`ExportProfile`
`presets`required	`object[]`
`presets[].id`required	`string`
`presets[].profile`required	`ExportProfile`

Response example

{
  "ok": true,
  "data": {
    "defaultProfile": {
      "container": "mp4",
      "codec": "h264",
      "resolution": "720p",
      "fps": 24,
      "quality": "balanced",
      "colorDepth": 8,
      "audioBitrate": 128,
      "loudness": -14
    },
    "presets": [
      {
        "id": "string",
        "profile": {
          "container": "mp4",
          "codec": "h264",
          "resolution": "720p",
          "fps": null,
          "quality": "balanced",
          "colorDepth": null,
          "audioBitrate": null,
          "loudness": null
        }
      }
    ]
  }
}

Price of an operation

POST/v1/estimate

Scopes: any token
Rate limit: default

Request body `EstimateRequest`

Field	Type	Description
`kind`required	`string`	`montage` · `remount` · `retry` · `assistant` · `translate` · `transcribe`
`projectId`	`integer`	For retry and transcribe

Request

curl

JavaScript

Python

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

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

import os
import requests

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

Response

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 example

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

This specification (OpenAPI 3.1)

GET/v1/openapi.json

Scopes: no token
Rate limit: default

Request

curl

JavaScript

Python

curl "https://api.slicer.media/v1/openapi.json"

const response = await fetch('https://api.slicer.media/v1/openapi.json');
const { ok, data, error } = await response.json();

import requests

response = requests.get(
    "https://api.slicer.media/v1/openapi.json",
)
body = response.json()

Response

The response body is described on this page.

Schemas

Styles — Same catalog as the apps use: ids, titles (ru/en), descriptions, defaults and prices

Field	Type	Description
`templates`required	`object[]`
`templates[].id`required	`string`
`fonts`required	`object[]`
`fonts[].id`required	`string`
`colors`required	`object[]`
`colors[].id`required	`string`
`subtitleDesigns`required	`object[]`
`subtitleDesigns[].id`required	`string`
`subtitleOptions`	`object[]`	Caption options (word highlight, entrance, words on screen, letter case) with their values
`subtitleOptions[].id`required	`string`
`params`required	`object[]`
`params[].id`required	`string`
`direction`required	`object`
`defaults`required	`object`
`pricing`required	`object`

MontageSettingsInput — Any subset of montage settings; missing values — defaults, unknown ids — defaults

Field	Type	Description
`templateId`	`string`	Template: `bold`, `clean`, `pop`
`fontId`	`string`	Caption font: punch, poster, block, wide, editorial, rounded, script, mono
`colorId`	`string`	Accent: amber, azure, lime, crimson, fuchsia, mint, violet, white
`subtitles`	`object`	Caption look; a partial change keeps the other fields. A new `design` without `highlight`/`animation`/`words` resets them to `auto`
`subtitles.enabled`	`boolean`
`subtitles.design`	`string`	`dynamic` · `karaoke` · `classic` · `minimal` · `pop` · `box` · `word`
`subtitles.size`	`string`	`small` · `medium` · `large`
`subtitles.position`	`string`	`auto` — each phrase where the frame has the most free space (off the face, hook, plaques, titles)`auto` · `top` · `center` · `bottom`
`subtitles.speakerColors`	`boolean`	Each speaker in its own colour
`subtitles.highlight`	`string`	The spoken word: colour, pop (grows), box, underline; `auto` — as the design intends`auto` · `none` · `color` · `pop` · `box` · `underline`
`subtitles.animation`	`string`	Phrase entrance; `words` — word by word as spoken`auto` · `none` · `fade` · `pop` · `slide` · `words`
`subtitles.words`	`string`	Words on screen at once`auto` · `one` · `few` · `line` · `phrase`
`subtitles.letterCase`	`string`	Letter case; `auto` — as the font intends`auto` · `upper` · `normal`
`params`	`object`	Montage parameters, see `GET /v1/styles` → `params`
`params.emoji`	`boolean`
`params.soundEffects`	`boolean`
`params.mediaCards`	`boolean`
`params.plaques`	`boolean`
`params.cameraMotion`	`boolean`
`params.introZoom`	`boolean`
`params.hook`	`boolean`
`smartCut`	`boolean`	Smart cut: remove pauses and retakes
`targetDurationSec`	`15 \| 30 \| 60 \| 90 \| null`	Target length; `null` — AI decides (up to 90 s)
`language`	`string`	`auto` · `ru` · `en`
`direction`	`object`
`direction.mode`	`string`	`auto` · `talking` · `story` · `product` · `aesthetic`
`direction.pace`	`string`	`calm` · `balanced` · `dynamic`
`direction.effects`	`string`	`off` · `light` · `bold`
`direction.narration`	`boolean`	AI voiceover
`direction.voice`	`string`	`warm` · `soft` · `confident` · `deep`

ExportProfile

Field	Type	Description
`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-bit only with HEVC
`audioBitrate`	`128 \| 192 \| 256 \| 320`
`loudness`	`-14 \| -16 \| -23`	Target loudness, LUFS

Quote

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

Styles, settings and prices#

Request

Response

Export presets and the default profile#

Request

Response

Price of an operation#

Request body EstimateRequest

Request

Response

This specification (OpenAPI 3.1)#

Request

Response

Schemas#

Styles, settings and prices

Export presets and the default profile

Price of an operation

Request body `EstimateRequest`

This specification (OpenAPI 3.1)

Schemas