API для разработчиков · MCP-сервер

Нарезайте клипы YouTube прямо из своего кода.

Name: AppsGolem API & MCP
Price: 5 EUR
Availability: InStock

Простой REST API и MCP-сервер для AI-агентов — всё, что умеет веб-версия, но программно. Предоплаченные кредиты, без подписки.

Получить API-ключ Быстрый старт

API + MCP для агентов разработки →

# one clip = 1 credit — failed cuts never billed
curl -X POST https://appsgolem.com/v1/cuts \
  -H "Authorization: Bearer ag_live_…" \
  -d '{"url":"youtu.be/…","start":"0:00",
       "end":"0:10","mode":"video"}'

Как это работает

Впервые здесь? Вся модель за одну минуту.

Вы покупаете предоплаченные кредиты, создаёте API-ключ и вызываете один эндпоинт, чтобы вырезать клип. Нарезка выполняется асинхронно: вы отправляете задачу, опрашиваете статус, пока она не будет готова, а затем скачиваете файл по токенизированной ссылке. MCP-сервер оборачивает всё это в один вызов инструмента для ИИ-агентов. Никакой подписки, никаких мест — вы платите за каждый готовый клип.

1 · Аутентификация

Отправляйте свой ключ как Authorization: Bearer ag_live_… в каждом запросе.

2 · Отправка и опрос

POST /v1/cuts возвращает идентификатор задачи; опрашивайте GET /v1/cuts/{id}, пока клип не будет готов.

3 · Скачать

Получите download_url из готовой задачи — заголовок не нужен, токен авторизует сам себя.

Быстрый старт

От нуля до клипа за четыре запроса.

01

Создайте API-ключ

Buy a credit pack (from €5), then generate a key in your dashboard. Keys look like ag_live_… and are shown once — store it somewhere safe.

02

Отправьте запрос на нарезку

curl -X POST https://appsgolem.com/v1/cuts \
  -H "Authorization: Bearer ag_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://youtu.be/aqz-KE-bpKQ",
       "start":"0:00","end":"0:10",
       "resolution":"1080p","mode":"video"}'

import httpx
r = httpx.post("https://appsgolem.com/v1/cuts",
  headers={"Authorization": "Bearer ag_live_…"},
  json={"url": "https://youtu.be/aqz-KE-bpKQ",
        "start": "0:00", "end": "0:10",
        "resolution": "1080p", "mode": "video"})
print(r.json())   # {"id": "…", "state": "queued"}

const r = await fetch("https://appsgolem.com/v1/cuts", {
  method: "POST",
  headers: { Authorization: "Bearer ag_live_…" },
  body: JSON.stringify({
    url: "https://youtu.be/aqz-KE-bpKQ",
    start: "0:00", end: "0:10",
    resolution: "1080p", mode: "video" }),
});
console.log(await r.json());

202 Accepted

{ "id": "e48d…b1a2", "state": "queued", "credits_reserved": 1, "poll_url": "/v1/cuts/e48d…b1a2" }

03

Опрашивайте URL для скачивания

# GET /v1/cuts/{id} — repeat every few seconds until state is produced
{ "state": "produced",
  "download_url": "/v1/download/…/clip.mp4" }

Статусы меняются так: accepted → queued → produced → delivered (или failed → refunded). Короткий клип обычно готов за секунды; опрашивайте каждые 3–5 с.

Ссылки для скачивания действительны 72 часа после создания клипа — скачайте его в течение этого времени.

04

Скачайте клип

Токенизированный URL передаёт поток MP4 — его можно использовать повторно до истечения срока действия. Инструмент MCP cut_youtube_video выполняет шаги 2–4 за один вызов.

Для AI-агентов · MCP

Одна строка для Claude, Cursor и Codex.

MCP-сервер предоставляет функции нарезки в виде трёх инструментов, которые может вызвать любой MCP-клиент. Устанавливается через npx — ничего не нужно устанавливать глобально.

Claude Desktop — claude_desktop_config.json

{ "mcpServers": {
  "appsgolem": {
    "command": "npx",
    "args": ["-y","appsgolem-mcp"],
    "env": { "APPSGOLEM_API_KEY":
      "ag_live_…" } } } }

Claude Code

claude mcp add appsgolem \
  -e APPSGOLEM_API_KEY=ag_live_… \
  -- npx -y appsgolem-mcp

Codex CLI — ~/.codex/config.toml

[mcp_servers.appsgolem]
command = "npx"
args = ["-y", "appsgolem-mcp"]
env = { APPSGOLEM_API_KEY = "ag_live_…" }

cut_youtube_video()

Отправьте запрос на нарезку (любой режим, параметры или массив clips) и получите URL для скачивания.

get_cut_status()

Проверьте задачу по ID и получите её URL для скачивания.

get_account_balance()

Ваши доступные кредиты и часовой лимит.

Что сказать своему агенту — все возможности

“Вырезать фрагмент видео с 0:30 до 1:15 в 1080p”

cut_youtube_video(url, start="0:30", end="1:15", resolution="1080p")

“Извлечь аудио этого видео с 2:00–5:00 в виде MP3 320 kbps”

cut_youtube_video(…, mode="audio_only", audio_format="mp3", bitrate="320")

“Экспортировать видео и MP3 первых 30 секунд”

cut_youtube_video(…, end="0:30", mode="both")

“Сделать вертикальный ролик 9:16 из фрагмента 10:00–10:45”

cut_youtube_video(…, start="10:00", end="10:45", mode="short")

“Превратить 0:05–0:12 в GIF”

cut_youtube_video(…, mode="gif")

“Извлечь контактный лист кадров каждые 5 секунд с 1:00 до 2:00”

cut_youtube_video(…, mode="frames", interval_ms=5000, sheet=true)

“Склеить 0:10–0:20 и 1:00–1:10 в один клип”

cut_youtube_video(url, clips=[…], stitch=true)

“Сделать нарезку первых 30 секунд в режиме fast, stream-copy”

cut_youtube_video(…, end="0:30", fast=true)

“Вырезать 0:00–0:20 на скорости 1.5×, в 4K”

cut_youtube_video(…, speed=1.5, resolution="2160p")

“Сколько у меня осталось API-кредитов?”

get_account_balance()

“Проверить статус задачи e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

Агент сам заполняет параметры из вашего запроса — писать JSON не нужно.

Справочник API

Каждый эндпоинт с примерами.

Четыре эндпоинта. Три эндпоинта для чтения/записи принимают Authorization: Bearer <key>; ссылка на скачивание авторизуется собственным токеном, поэтому заголовок не нужен.

POST /v1/cuts Bearer

Запрос · video

{ "url": "https://youtu.be/aqz-KE-bpKQ",
  "start": "0:00", "end": "0:10",
  "resolution": "1080p", "mode": "video" }

Ответ · 202 Accepted

{ "id": "e48db1a2-…", "state": "queued", "credits_reserved": 1, "poll_url": "/v1/cuts/e48db1a2-…" }

Передайте либо start+end, либо массив clips (1–10 отрезков). Добавьте заголовок Idempotency-Key (≤200 символов), чтобы повторный запрос переиспользовал ту же задачу вместо повторного списания.

Тело запроса для каждого режима

audio_onlymp3 · m4a · wav · flac

{ "url":"youtu.be/…", "start":"2:00", "end":"5:00",
  "mode":"audio_only",
  "audio_format":"mp3", "bitrate":"320" }

bothMP4 + MP3, в ZIP-архиве

{ "url":"youtu.be/…", "start":"0:00", "end":"0:30",
  "mode":"both", "resolution":"1080p" }

short9:16 с умным кадрированием ИИ

{ "url":"youtu.be/…", "start":"10:00", "end":"10:45",
  "mode":"short" }

nosoundMP4 без звука

{ "url":"youtu.be/…", "start":"0:00", "end":"0:15",
  "mode":"nosound", "fast":true }

gif≤ 5 мин, один клип

{ "url":"youtu.be/…", "start":"0:05", "end":"0:12",
  "mode":"gif" }

framesКадры JPG · ≤ 1800

{ "url":"youtu.be/…", "start":"1:00", "end":"2:00",
  "mode":"frames", "interval_ms":5000,
  "sheet":true }

clips + stitch1–10 → один файл

{ "url":"youtu.be/…", "mode":"video",
  "clips":[{"start":"0:10","end":"0:20"},
          {"start":"1:00","end":"1:10"}],
  "stitch":true }

speed · 4K0.5–2× · 2160p

{ "url":"youtu.be/…", "start":"0:00", "end":"0:20",
  "mode":"video", "speed":1.5,
  "resolution":"2160p" }

GET /v1/cuts/{id} Bearer

Ответ · 200 · produced

{ "id": "e48db1a2-…", "state": "produced", "credits_reserved": 1,
  "created_at": "2026-08-22T12:00:00+00:00",
  "download_url": "/v1/download/…/clip.mp4" }

state принимает одно из значений: accepted · queued · produced · delivered · failed · refunded. download_url появляется, когда токен готов — если его нет, опросите снова.

GET /v1/account Bearer

Ответ · 200

{ "balance": 412, "hourly_cap": 60 }

GET /v1/download/{token}/{file} Токен в URL

Ответ · 200

# streams the file
Content-Type: video/mp4
Content-Disposition: attachment; filename="clip.mp4"

Заголовок Bearer не нужен — авторизация выполняется токеном в пути. Ссылку можно использовать повторно до истечения срока действия.

Ошибки

Каждая ошибка возвращает тело JSON с кодом error и HTTP-статусом. При 429 повторите запрос через retry_after секунд; при 400 исправьте и отправьте заново.

402 insufficient_credits

{ "error":"insufficient_credits",
  "message":"need 2 credits", "balance":1 }

429 rate_limited

{ "error":"rate_limited",
  "retry_after":12 }

400 invalid_*

{ "error":"invalid_resolution",
  "message":"resolution must be…" }

401 · 404

{ "error":"invalid_api_key" }  // 401
{ "error":"not_found" }        // 404

Лимит запросов: Ограничение по частоте запросов касается только заявок на нарезку — количество заявок в час зависит от вашего тарифа (см. раздел «Тарифы»). Проверка статуса задачи не ограничивается по частоте при обычном использовании, поэтому опрос никогда не учитывается в этом лимите. Учитывайте poll_after в каждом ответе (а также Retry-After при редком коде 429); инструмент MCP делает это за вас, если указан wait=true.

Возможности

Все режимы, доступные в веб-версии.

MODE video

MP4 до 4K

144p–2160p, 60fps, без водяного знака.

MODE audio_only

Звук

mp3 / m4a / wav / flac, выбор битрейта.

MODE both

Видео + аудио

MP4 и MP3 вместе, в виде zip-архива.

MODE nosound

Видео без звука

Видео без звуковой дорожки.

MODE short

9:16 вертикально

Умная обрезка на базе AI для Shorts, Reels и TikTok; при недоступности используются размытые чёрные полосы.

MODE gif

Анимированный GIF

До 5 минут, прямо из клипа.

MODE frames

Кадры JPG

Каждые 100ms–10s, метки времени + контактный лист.

OPTION fast

Быстрый режим

Потоковое копирование, примерно в 10× быстрее; сохраняет исходный контейнер (WebM в 1440p/2160p).

OPTION speed

Скорость 0.5–2×

Изменение темпа воспроизведения при экспорте.

OPTION clips

Склейка нескольких клипов

До 10 отрезков, объединённых в один файл.

Справочник

Параметры

Поле

Тип

Примечания

url

string

YouTube watch / share / youtu.be URL.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Не указывается при использовании clips.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; общая длительность нарезки ≤ 60 min).

mode

enum

video · audio_only · both · nosound · short · gif · frames.

audio_format

enum

mp3 · m4a · wav · flac — только для audio_only; both — всегда MP3.

bitrate

enum

Битрейт с потерями 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); игнорируется для wav/flac.

fast

boolean

Stream-copy, примерно в 10× быстрее — только video, nosound, both; принудительно устанавливает speed на 1×.

speed

number

Скорость воспроизведения 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Частота выборки кадров: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG всего.

burn_ts

boolean

Кадры — впечатывает исходную метку времени на каждый JPG.

sheet

boolean

Кадры — один контактный лист в формате JPG (один клип); отключает burn_ts.

clips

array

1–10 отрезков {start,end}; включите stitch, чтобы объединить их в один файл.

stitch

boolean

При использовании clips объединяет их в один файл — video, audio_only, both, short, nosound.

Idempotency-Key

header

Отправляется как заголовок HTTP (≤ 200 символов), а не поле тела — повторные попытки используют то же задание.

Эндпоинты: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Bearer-аутентификация.
GET /v1/download/{token}/{file} — аутентификация по токену в URL, без заголовка Bearer.

Цены

Платите за клипы, а не за места.

Предоплаченные кредиты обеспечивают работу API для нарезки видео AppsGolem & сервера MCP — один готовый клип равен одному кредиту, а неудачные нарезки никогда не оплачиваются. Купите пакет для нечастого использования или оформите подписку для стабильного ежемесячного объёма и более высокого лимита запросов.

№ 01 / Предоплаченные пакеты