Account

Slicer API account endpoints — profile, token balance, the free first video, the token's scopes and spend limit, and wallet transaction history.

On this page

Current account and token
Wallet transactions
Schemas

Details of the account and of the token used for the request: balance, whether the free first video is available, scopes, spend limit and how much of it was spent this month. You can't top up through the API — token packs are bought in the app (Balance and packs).

Current account and token

GET/v1/me

Scopes: account:read
Rate limit: default

Request

curl

JavaScript

Python

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

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

Response

Response fields: Me (14)

Field	Type	Description
`id`required	`integer`
`name`required	`string \| null`
`language`required	`string`	`ru` · `en`
`wallet`required	`object`
`wallet.balance`required	`integer`	Token balance
`wallet.held`required	`integer`	Reserved for running jobs
`wallet.available`required	`integer`	Available to spend
`wallet.freeMontageAvailable`required	`boolean`	The first video is free (with a watermark)
`wallet.montageTokens`required	`integer`	Price of one montage
`token`required	`object`
`token.kind`required	`string`	`personal` · `oauth`
`token.scopes`required	`string[]`
`token.spendLimit`required	`integer \| null`
`token.spentThisMonth`required	`integer`

Response example

{
  "ok": true,
  "data": {
    "id": 42,
    "name": "Anna",
    "language": "ru",
    "wallet": {
      "balance": 240,
      "held": 0,
      "available": 240,
      "freeMontageAvailable": true,
      "montageTokens": 24
    },
    "token": {
      "kind": "personal",
      "scopes": [
        "account:read"
      ],
      "spendLimit": 200,
      "spentThisMonth": 0
    }
  }
}

Wallet transactions

GET/v1/wallet/transactions

Scopes: account:read
Rate limit: default

Query parameters

Field	Type	Description
`limit`	`integer`	1–100
`cursor`	`string`	≤ 200

Request

curl

JavaScript

Python

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

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

Response

Response fields: object (2)

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

Response example

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": 42,
        "type": "topup",
        "amount": 1,
        "description": "string",
        "projectId": 42,
        "createdAt": "2026-10-16T09:30:00Z"
      }
    ],
    "nextCursor": "eyJpZCI6NDJ9"
  }
}

Schemas

Me

Field	Type	Description
`id`required	`integer`
`name`required	`string \| null`
`language`required	`string`	`ru` · `en`
`wallet`required	`object`
`wallet.balance`required	`integer`	Token balance
`wallet.held`required	`integer`	Reserved for running jobs
`wallet.available`required	`integer`	Available to spend
`wallet.freeMontageAvailable`required	`boolean`	The first video is free (with a watermark)
`wallet.montageTokens`required	`integer`	Price of one montage
`token`required	`object`
`token.kind`required	`string`	`personal` · `oauth`
`token.scopes`required	`string[]`
`token.spendLimit`required	`integer \| null`
`token.spentThisMonth`required	`integer`

WalletTransaction

Field	Type	Description
`id`required	`integer`
`type`required	`string`	`topup` · `bonus` · `charge` · `refund` · `adjustment`
`amount`required	`integer`	Tokens: positive — credit, negative — charge
`description`required	`string \| null`
`projectId`required	`integer \| null`
`createdAt`required	`string`	ISO 8601 date-time, UTC

Current account and token#

Request

Response

Wallet transactions#

Query parameters

Request

Response

Schemas#

Current account and token

Wallet transactions

Schemas