Аккаунт

Эндпоинты аккаунта Slicer API — профиль, баланс токенов, бесплатный первый ролик, области и лимит расходов токена, история операций кошелька.

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

Аккаунт и токен
Операции кошелька
Схемы

Сведения об аккаунте и токене, с которым сделан запрос: баланс, доступно ли бесплатное первое видео, области доступа, лимит расходов и сколько из него потрачено в этом месяце. Пополнить баланс через API нельзя — пакеты покупаются в приложении (Баланс и пакеты).

Аккаунт и токен

GET/v1/me

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

Запрос

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()

Ответ

Поля ответа: Me (14)

Поле	Тип	Описание
`id`обязательное	`integer`
`name`обязательное	`string \| null`
`language`обязательное	`string`	`ru` · `en`
`wallet`обязательное	`object`
`wallet.balance`обязательное	`integer`	Баланс токенов
`wallet.held`обязательное	`integer`	Зарезервировано под идущие работы
`wallet.available`обязательное	`integer`	Можно потратить
`wallet.freeMontageAvailable`обязательное	`boolean`	Первый ролик бесплатно (с водяным знаком)
`wallet.montageTokens`обязательное	`integer`	Цена одного монтажа
`token`обязательное	`object`
`token.kind`обязательное	`string`	`personal` · `oauth`
`token.scopes`обязательное	`string[]`
`token.spendLimit`обязательное	`integer \| null`
`token.spentThisMonth`обязательное	`integer`

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

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

Операции кошелька

GET/v1/wallet/transactions

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

Параметры запроса

Поле	Тип	Описание
`limit`	`integer`	1–100
`cursor`	`string`	≤ 200

Запрос

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()

Ответ

Поля ответа: object (2)

Поле	Тип	Описание
`items`обязательное	`WalletTransaction[]`
`nextCursor`обязательное	`string \| null`

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

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

Схемы

Me

Поле	Тип	Описание
`id`обязательное	`integer`
`name`обязательное	`string \| null`
`language`обязательное	`string`	`ru` · `en`
`wallet`обязательное	`object`
`wallet.balance`обязательное	`integer`	Баланс токенов
`wallet.held`обязательное	`integer`	Зарезервировано под идущие работы
`wallet.available`обязательное	`integer`	Можно потратить
`wallet.freeMontageAvailable`обязательное	`boolean`	Первый ролик бесплатно (с водяным знаком)
`wallet.montageTokens`обязательное	`integer`	Цена одного монтажа
`token`обязательное	`object`
`token.kind`обязательное	`string`	`personal` · `oauth`
`token.scopes`обязательное	`string[]`
`token.spendLimit`обязательное	`integer \| null`
`token.spentThisMonth`обязательное	`integer`

WalletTransaction

Поле	Тип	Описание
`id`обязательное	`integer`
`type`обязательное	`string`	`topup` · `bonus` · `charge` · `refund` · `adjustment`
`amount`обязательное	`integer`	Токены: плюс — начисление, минус — списание
`description`обязательное	`string \| null`
`projectId`обязательное	`integer \| null`
`createdAt`обязательное	`string`	Дата и время ISO 8601, UTC

Аккаунт и токен#

Запрос

Ответ

Операции кошелька#

Параметры запроса

Запрос

Ответ

Схемы#

Аккаунт и токен

Операции кошелька

Схемы