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 ключ и извиквате един ендпойнт, за да изрежете клип. Изрязването е асинхронно: изпращате задача, проверявате статуса ѝ, докато бъде готова, след което изтегляте файла от токенизиран URL адрес. 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()

Изпратете заявка за изрязване (произволен режим, опции или масив от клипове) и получете обратно 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>; URL адресът за изтегляне се оторизира от собствения си токен, така че не се нуждае от хедър.

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

framesJPG кадри · ≤ 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 хедър — токенът в пътя оторизира заявката. URL адресът може да се използва многократно до изтичане на срока му.

Грешки

Всеки неуспех връща 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 URL адрес за гледане / споделяне / youtu.be.

start, end

string

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

resolution

enum

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

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 / Предплатени пакети

Плащай според използването.

Еднократна покупка без подновяване. Кредитите остават валидни 12 месеца.

Стартов пакет

€5 еднократно плащане

25 кредита · ≈ 25 стандартни клипа

Валидни 12 месеца

Започнете

PAYG пакет Най-изгодно

€25 еднократно плащане

150 кредита · ≈ 150 стандартни клипа

Валидни 12 месеца · €0,17 / кредит

Започнете

№ 02 / Абонаменти

Изрязвай всеки месец.

Кредитите се подновяват всеки период, а лимитът на заявките ви се повишава. Отказ по всяко време.

Стартов

€19 / мес.

или €190 / г. · 2 месеца безплатно

250 кредита / месец

30 заявки / час
Кредитите се подновяват месечно
Отказ по всяко време

Започнете

★ Най-популярен Pro

€49 / мес.

или €490 / г. · 2 месеца безплатно

1000 кредита / месец

60 заявки / час
Кредитите се подновяват месечно
Отказ по всяко време

Започнете

Растеж

€149 / мес.

или €1490 / г. · 2 месеца безплатно

5000 кредита / месец

120 заявки / час
Кредитите се подновяват месечно
Отказ по всяко време

Започнете

Абонаментите предоставят кредитите за целия период наведнъж и повишават лимита на заявките ви на час. Годишните планове се таксуват като 10 месеца вместо 12.

№ 03 / Как работят кредитите