API za programere · MCP server

Isecite YouTube klipove iz svog koda.

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

Jednostavan REST API i MCP server za AI agente — sve što radi veb alat za sečenje, programski. Unapred plaćeni krediti, bez pretplate.

Nabavite API ključ Brzi početak

API + MCP za agente za kodiranje →

# 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 враћа ID посла; проверавајте GET /v1/cuts/{id} док не буде готов.

3 · Преузми

Преузмите download_url из завршеног посла — заглавље није потребно, токен сам себе ауторизује.

Brzi početak

Od nule do klipa u četiri poziva.

01

Napravite API ključ

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

Pošaljite zahtev za sečenje

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

Proveravajte URL za preuzimanje

# 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 s.

Linkovi za preuzimanje ističu 72 sata nakon što je isečak napravljen — preuzmite ga u tom vremenskom okviru.

04

Preuzmite klip

Tokenizovani URL strimuje MP4 — može se ponovo koristiti dok ne istekne. MCP alat cut_youtube_video obavlja korake 2–4 umesto vas, u jednom pozivu.

Za AI agente · 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()

Pošaljite sečenje (bilo koji režim, opcije ili niz clips) i dobijte URL za preuzimanje.

get_cut_status()

Proverite zadatak po id-u i preuzmite njegov URL za preuzimanje.

get_account_balance()

Vaši raspoloživi krediti i satno ograničenje.

Шта рећи свом агенту — све могућности

“Исеци од 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

Ограничење захтева: Ograničenje broja zahteva odnosi se samo na slanja zahteva za sečenje — broj slanja po satu zavisi od vašeg plana (videti Cenovnik). Provera napretka posla nije ograničena pri uobičajenoj upotrebi, tako da periodično proveravanje statusa nikada ne ulazi u taj limit. Poštujte vrednost poll_after u svakom odgovoru (a kod retke greške 429 i zaglavlje Retry-After); MCP alat to automatski usklađuje umesto vas pomoću wait=true.

Mogućnosti

Svaki режим koji ima veb alat za sečenje.

MODE video

MP4 до 4K

144p–2160p, 60fps, bez vodenog žiga.

MODE audio_only

Звук

mp3 / m4a / wav / flac, bitrate po izboru.

MODE both

Video + audio

MP4 i MP3 zajedno, kao zip.

MODE nosound

Нечујни видео

Video bez zvučne staze.

MODE short

9:16 усправно

AI паметно кадрирање за Shorts, Reels и TikTok; ако није доступно, користе се замућене црне траке.

MODE gif

Animirani GIF

Do 5 minuta, direktno iz klipa.

MODE frames

JPG kadrovi

Svakih 100ms–10s, vremenske oznake + kontakt list.

OPTION fast

Брзи режим

Stream-copy, oko 10× brže; zadržava izvorni kontejner (WebM u 1440p/2160p).

OPTION speed

Brzina 0.5–2×

Podesite brzinu reprodukcije prilikom izvoza.

OPTION clips

Spajanje više klipova

Do 10 vremenskih prozora spojenih u jedan fajl.

Referenca

Parametri

Polje

Тип

Напомене

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

Brzina reprodukcije 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

Kadrovi — utiskuje izvornu vremensku oznaku na svaki JPG.

sheet

boolean

Кадрови — један JPG контакт-лист (један клип); онемогућава burn_ts.

clips

array

1–10 {start,end} временских прозора; поставите stitch да бисте их спојили у један фајл.

stitch

boolean

Uz clips, spaja ih u jedan fajl — video, audio_only, both, short, nosound.

Idempotency-Key

header

Шаље се као HTTP заглавље (≤ 200 знакова), не као поље у телу — поновни покушаји користе исти посао.

Krajnje tačke: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Autentifikacija Bearer tokenom.
GET /v1/download/{token}/{file} — autentifikacija URL tokenom, bez Bearer zaglavlja.

Цене

Plaćate klipove, ne mesta.

Unapred plaćeni krediti pokreću API AppsGolem alata za sečenje & MCP server — jedan proizveden isečak je jedan kredit, a neuspeli isečci se nikada ne naplaćuju. Kupite paket za povremenu upotrebu ili se pretplatite na stalan mesečni obim i veće ograničenje brzine.

№ 01 / Unapred plaćeni paketi