Fejlesztői API · MCP szerver

Vágj YouTube-klipeket a saját kódodból.

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

Egyszerű REST API és MCP szerver AI ügynökök számára — minden, amit a webes vágó tud, programozottan. Előre fizetett kreditek, előfizetés nélkül.

API-kulcs beszerzése Gyorsindítás

API + MCP kódoló ügynökök számára →

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

Hogyan működik

Most jársz itt először? A teljes modell egy perc alatt.

Előre kifizetett kreditet vásárolsz, létrehozol egy API-kulcsot, és egyetlen végpontot hívsz meg egy klip vágásához. A vágás aszinkron: elküldöd a feladatot, lekérdezed az állapotát, amíg el nem készül, majd letöltöd a fájlt egy tokenizált URL-ről. Az MCP-szerver mindezt egyetlen eszközhívásba csomagolja az AI-ügynökök számára. Nincs előfizetés, nincsenek felhasználói helyek — csak az elkészült klipekért fizetsz.

1 · Hitelesítés

Küldd el a kulcsodat minden kérésben Authorization: Bearer ag_live_… formátumban.

2 · Küldés és lekérdezés

A POST /v1/cuts visszaad egy feladatazonosítót; kérdezd le a(z) GET /v1/cuts/{id} végpontot, amíg el nem készül.

3 · Letöltés

Kérd le a download_url értéket az elkészült feladatból — nincs szükség fejlécre, a token önmagában hitelesíti.

Gyorsindítás

Nulláról klipig négy hívással.

01

API-kulcs létrehozása

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

Vágás beküldése

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

Letöltési URL lekérdezése

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

Az állapotok így haladnak: accepted → queued → produced → delivered (vagy failed → refunded). Egy rövid klip általában másodpercek alatt elkészül; kérdezd le 3–5 másodpercenként.

A letöltési linkek a klip elkészülte után 72 órával lejárnak — ezen az időn belül töltsd le.

04

Klip letöltése

A tokenizált URL streameli az MP4-et — a lejáratáig újra felhasználható. Az MCP cut_youtube_video eszköz a 2–4. lépést egyetlen hívással elvégzi helyetted.

AI ügynököknek · MCP

Egy sor a Claude-hoz, a Cursorhoz és a Codexhez.

Az MCP szerver a vágót három eszközként teszi elérhetővé, amelyet bármelyik MCP kliens meghívhat. Telepítsd npx-szel — semmit sem kell globálisan telepíteni.

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

Küldj be egy vágást (bármilyen módban, opciókkal vagy clips tömbbel), és kapj vissza egy letöltési URL-t.

get_cut_status()

Ellenőrizz egy feladatot id alapján, és kérd le a letöltési URL-jét.

get_account_balance()

Elkölthető kreditjeid és az óránkénti korlát.

Mit mondj az ügynöködnek — minden képesség

“Vágd ki a videó 0:30–1:15 közötti részét 1080p minőségben”

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

“Vedd ki ennek a videónak a hangját a 2:00–5:00 közötti részből 320 kbps-es MP3-ként”

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

“Exportáld a videót és az első 30 másodperc MP3-ját”

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

“Készíts egy 9:16-os függőleges rövid videót a 10:00–10:45 közötti kiemelt részből”

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

“Alakítsd a 0:05–0:12 részt GIF-fé”

cut_youtube_video(…, mode="gif")

“Készíts contact sheet-et a képkockákból 5 másodpercenként az 1:00–2:00 közötti részből”

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

“Stitch a 0:10–0:20 és 1:00–1:10 közötti részeket egyetlen klippé”

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

“Készíts egy fast, stream-copy típusú vágást az első 30 másodpercből”

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

“Vágd ki a 0:00–0:20 részt 1.5× sebességgel, 4K minőségben”

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

“Hány API-kreditem maradt?”

get_account_balance()

“Ellenőrizd az e48d…b1a2 feladat állapotát”

get_cut_status(job_id="e48d…b1a2")

Az ügynök a kérésed alapján tölti ki a paramétereket — nem kell JSON-t írnod.

API-referencia

Minden végpont, példákkal.

Négy végpont. A három olvasási/írási végpont a(z) Authorization: Bearer <key> fejlécet igényli; a letöltési URL-t a saját tokenje hitelesíti, így nincs szükség fejlécre.

POST /v1/cuts Bearer

Kérés · video

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

Válasz · 202 Accepted

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

Add meg vagy a start+end párost, vagy egy clips tömböt (1–10 időintervallum). Adj hozzá egy Idempotency-Key fejlécet (≤200 karakter), hogy egy megismételt kérés ugyanazt a feladatot használja újra, ne kétszer terhelje meg a fiókodat.

Kérés törzse módonként

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-fájlban

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

short9:16 AI smart-crop

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

nosoundMP4, hang nélkül

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

gif≤ 5 min, egyetlen klip

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

framesJPG állóképek · ≤ 1800

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

clips + stitch1–10 → egy fájl

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

Válasz · 200 · produced

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

A state egyike a következőknek: accepted · queued · produced · delivered · failed · refunded. A download_url akkor jelenik meg, amikor a token elkészül — ha hiányzik, kérdezd le újra.

GET /v1/account Bearer

Válasz · 200

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

GET /v1/download/{token}/{file} Token az URL-ben

Válasz · 200

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

Nincs Bearer fejléc — az elérési útban lévő token hitelesíti. Az URL újra felhasználható, amíg le nem jár.

Hibák

Minden hiba egy JSON törzset ad vissza egy error kóddal és a HTTP-állapottal. A 429-et próbáld újra retry_after másodperc múlva; 400 esetén javítsd ki és küldd el újra.

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

Kérési korlát: Csak a vágási beküldések vannak sebességkorlátozva — a csomagod beküldés/óra kerete (lásd: Árazás). Egy feladat állapotának lekérdezése normál használat esetén nincs korlátozva, így a lekérdezés soha nem számít bele ebbe a keretbe. Vedd figyelembe a poll_after értékét minden válaszban (és a ritka 429 esetén a Retry-After értéket); az MCP-eszköz wait=true esetén ezt automatikusan ütemezi helyetted.

Képességek

A webes vágó minden módja.

MODE video

MP4 akár 4K-ban

144p–2160p, 60fps, vízjel nélkül.

MODE audio_only

Hang

mp3 / m4a / wav / flac, választható bitráta.

MODE both

Videó + hang

MP4 és MP3 együtt, zip fájlban.

MODE nosound

Néma videó

Videó hangsáv nélkül.

MODE short

9:16 álló

AI intelligens kivágás Shorts, Reels és TikTok tartalmakhoz; ha ez nem érhető el, elmosott sávokra vált.

MODE gif

Animált GIF

Legfeljebb 5 perc, közvetlenül egy klipből.

MODE frames

JPG képkockák

100ms–10s-enként, időbélyegekkel + kontaktkópiával.

OPTION fast

Gyors mód

Stream-másolás, kb. 10×-szer gyorsabb; megtartja a forrás konténerformátumát (WebM 1440p/2160p esetén).

OPTION speed

Sebesség 0.5–2×

Lejátszási sebesség módosítása exportáláskor.

OPTION clips

Több klip összefűzése

Legfeljebb 10 szakasz egyetlen fájlba fűzve.

Referencia

Paraméterek

Mező

Típus

Megjegyzések

url

string

YouTube watch / share / youtu.be URL.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Hagyd ki, ha clips-et használsz.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; teljes vágás ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — csak audio_only esetén; a both mindig MP3.

bitrate

enum

Veszteséges bitráta 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); nem érvényes wav/flac esetén.

fast

boolean

Stream-copy, kb. 10× gyorsabb — csak video, nosound, both esetén; a sebességet 1×-re kényszeríti.

speed

number

Lejátszási sebesség 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Képkocka-mintavételezés: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; összesen ≤ 1800 JPG.

burn_ts

boolean

Képkockák — a forrás időbélyegének ráégetése minden JPG-re.

sheet

boolean

Képkockák — egyetlen JPG kontaktlap (egy klip esetén); letiltja a burn_ts-t.

clips

array

1–10 {start,end} szakasz; állítsd be a stitch-et, hogy egy fájlba fűzze őket.

stitch

boolean

clips esetén egy fájlba fűzve — video, audio_only, both, short, nosound.

Idempotency-Key

header

HTTP fejlécként (≤ 200 karakter) küldve, nem törzsmezőként — az újrapróbálkozások ugyanazt a jobot használják.

Végpontok: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Bearer-hitelesítéssel.
GET /v1/download/{token}/{file} — URL tokennel hitelesítve, nincs Bearer fejléc.

Árak

Klipekért fizetsz, nem helyekért.

Az előre fizetett kreditek működtetik az AppsGolem vágó API-t & MCP-szervert — egy elkészült klip egy kreditbe kerül, a sikertelen vágásokért pedig soha nem számlázunk. Vásárolj csomagot alkalmi használatra, vagy fizess elő állandó havi mennyiségre és magasabb sebességkorlátra.

№ 01 / Előre fizetett csomagok

Fizess használat szerint.

Egyszeri vásárlás, nincs megújítás. A kreditek 12 hónapig érvényesek.

Starter csomag

€5 egyszeri

25 kredit · ≈ 25 standard klip

12 hónapig érvényes

Kezdés

PAYG csomag Legjobb ár-érték arány

€25 egyszeri

150 kredit · ≈ 150 standard klip

12 hónapig érvényes · €0,17 / kredit

Kezdés

№ 02 / Előfizetések

Vágj minden hónapban.

A kreditek minden időszakban megújulnak, és a sebességkorlátod nő. Bármikor lemondhatod.

Starter

€19 / hó

vagy €190 / év · 2 hónap ingyen

250 kredit / hónap

30 kérés / óra
A kreditek havonta megújulnak
Bármikor lemondható

Kezdés

★ Legnépszerűbb Pro

€49 / hó

vagy €490 / év · 2 hónap ingyen

1000 kredit / hónap

60 kérés / óra
A kreditek havonta megújulnak
Bármikor lemondható

Kezdés

Scale

€149 / hó

vagy €1490 / év · 2 hónap ingyen

5000 kredit / hónap

120 kérés / óra
A kreditek havonta megújulnak
Bármikor lemondható

Kezdés

Az előfizetések a teljes időszak krediteit előre biztosítják, és megemelik a kérés/óra korlátodat. Az éves előfizetéseknél 10 hónapot számlázunk a 12 helyett.

№ 03 / Hogyan működnek a kreditek