Arendaja API · MCP server

Lõika YouTube'i klippe oma koodist.

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

Lihtne REST API ja MCP server AI-agentidele — kõik, mida veebilõikur teeb, programmiliselt. Ettemakstud krediidid, ilma tellimuseta.

Hangi API-võti Kiirjuhend

API + MCP koodiagentidele →

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

Kuidas see toimib

Esimest korda siin? Kogu mudel ühe minutiga.

Sa ostad ettemakstud krediite, loot API-võtme ja kutsud klipi lõikamiseks välja ühe otspunkti. Lõikamine on asünkroonne: esitad töö, teed päringuid, kuni see on valmis, seejärel laadid faili alla tokeniseeritud URL-i kaudu. MCP server pakib kõik selle tehisintellekti agentide jaoks ühte tööriistakutsesse. Tellimust ei ole, kasutajakohti ei ole — maksad iga valminud klipi eest.

1 · Autentimine

Saada oma võti iga päringuga kui Authorization: Bearer ag_live_….

2 · Esitamine ja pärimine

POST /v1/cuts tagastab töö id; tee päringuid GET /v1/cuts/{id}, kuni see on valmis.

3 · Laadi alla

Too download_url valminud töölt — päist pole vaja, seda autoriseerib token ise.

Kiirjuhend

Nullist klipini nelja päringuga.

01

Loo API võti

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

Esita lõige

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

Pärige allalaadimise URL-i

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

Olekud liiguvad nii: accepted → queued → produced → delivered (või failed → refunded). Lühike klipp on tavaliselt valmis mõne sekundiga; tee päringuid iga 3–5 s tagant.

Allalaadimislingid aeguvad 72 tundi pärast klipi valmimist — laadi see alla selle aja jooksul.

04

Laadi klipp alla

Tokeniga URL voogesitab MP4-faili — taaskasutatav kuni aegumiseni. MCP tööriist cut_youtube_video teeb sammud 2–4 sinu eest ühe päringuga.

AI-agentidele · MCP

Üks rida Claude'i, Cursori ja Codexi jaoks.

MCP server pakub lõikurit kolme tööriistana, mida iga MCP klient saab kutsuda. Paigalda käsuga npx — midagi ei pea globaalselt paigaldama.

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

Esita lõige (mis tahes режiim, valikud või klippide massiiv) ja saad vastu allalaadimise URL-i.

get_cut_status()

Kontrolli tööd id järgi ja hangi selle allalaadimise URL.

get_account_balance()

Sinu kasutatavad krediidid ja tunnipiirang.

Mida oma agendile öelda — kõik võimalused

“Lõika video 0:30–1:15 kvaliteediga 1080p”

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

“Võta selle video heli 2:00–5:00 vahemikust 320 kbps MP3-na”

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

“Ekspordi video ja esimese 30 sekundi MP3”

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

“Tee 9:16 vertikaalne lühivideo 10:00–10:45 haripunktist”

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

“Tee 0:05–0:12-st GIF”

cut_youtube_video(…, mode="gif")

“Tee kaadrite contact sheet iga 5 sekundi järel vahemikust 1:00–2:00”

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

“Stitch 0:10–0:20 ja 1:00–1:10 üheks klipiks”

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

“Tee fast, stream-copy tüüpi lõige esimesest 30 sekundist”

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

“Lõika 0:00–0:20 kiirusega 1.5×, kvaliteediga 4K”

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

“Mitu API krediiti mul veel on?”

get_account_balance()

“Kontrolli töö e48d…b1a2 olekut”

get_cut_status(job_id="e48d…b1a2")

Agent täidab parameetrid sinu päringu põhjal ise — sa ei pea JSON-i kirjutama.

API dokumentatsioon

Iga otspunkt koos näidetega.

Neli otspunkti. Kolm lugemis-/kirjutamisotspunkti nõuavad Authorization: Bearer <key>; allalaadimis-URL-i autoriseerib oma token, seega päist pole vaja.

POST /v1/cuts Bearer

Päring · video

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

Vastus · 202 Accepted

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

Anna kas start+end või clips massiiv (1–10 vahemikku). Lisa Idempotency-Key päis (≤200 tähemärki), et korduv päring kasutaks sama tööd, mitte ei võetaks tasu kaks korda.

Päringu keha režiimi kaupa

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-arhiivis

{ "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, ilma helita

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

gif≤ 5 min, üks klipp

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

framesJPG kaadrid · ≤ 1800

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

clips + stitch1–10 → üks fail

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

Vastus · 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 on üks järgnevatest: accepted · queued · produced · delivered · failed · refunded. download_url ilmub, kui token on valmis — kui seda pole, tee päring uuesti.

GET /v1/account Bearer

Vastus · 200

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

GET /v1/download/{token}/{file} Token URL-is

Vastus · 200

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

Bearer päist pole vaja — seda autoriseerib tee sees olev token. URL-i saab korduvalt kasutada, kuni see aegub.

Vead

Iga ebaõnnestumine tagastab JSON-keha koos error koodi ja HTTP olekuga. Proovi 429 uuesti pärast retry_after sekundit; 400 puhul paranda ja esita uuesti.

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

Päringute piirmäär: Ainult lõikamise esitused on kiiruspiiratud — sinu paketi esitused/tund (vt Hinnakiri). Töö oleku kontrollimine ei ole tavakasutuse korral kiiruspiiratud, seega olekupäringud ei mõjuta kunagi seda piirmäära. Järgi igas vastuses poll_after väärtust (ja harva esineva 429 puhul Retry-After väärtust); MCP-tööriist reguleerib seda sinu eest, kui kasutad wait=true.

Võimalused

Kõik veebilõikuri režiimid.

MODE video

MP4 kuni 4K

144p–2160p, 60fps, ilma vesimärgita.

MODE audio_only

Heli

mp3 / m4a / wav / flac, valitav bitikiirus.

MODE both

Video + heli

MP4 ja MP3 koos, zip-failina.

MODE nosound

Hääleta video

Video ilma helirajata.

MODE short

9:16 vertikaalne

AI-põhine nutikas kärpimine Shorts, Reels ja TikToki jaoks; kui see pole saadaval, lisatakse hägustatud taustaga mustad ribad.

MODE gif

Animeeritud GIF

Kuni 5 minutit, otse klipist.

MODE frames

JPG kaadrid

Iga 100ms–10s järel, ajatemplid + kontaktleht.

OPTION fast

Kiirrežiim

Voogkopeerimine, umbes 10× kiirem; säilitab algse konteineri (WebM 1440p/2160p juures).

OPTION speed

Kiirus 0.5–2×

Muuda taasesituse kiirust ekspordi ajal.

OPTION clips

Mitme klipi ühendamine

Kuni 10 ajavahemikku ühendatuna üheks failiks.

Viide

Parameetrid

Väli

Tüüp

Märkused

url

string

YouTube'i watch / share / youtu.be URL.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Jäta ära, kui kasutad klippe.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; lõike kogupikkus ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — ainult audio_only jaoks; both on alati MP3.

bitrate

enum

Kadudega bitikiirus 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); ei kehti wav/flac puhul.

fast

boolean

Stream-copy, umbes 10× kiirem — ainult video, nosound, both; sunnib kiiruse 1×-ks.

speed

number

Taasesituskiirus 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Kaadrite võtmise intervall: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG-i kokku.

burn_ts

boolean

Kaadrid — trükib lähtevideo ajatempli igale JPG-le peale.

sheet

boolean

Kaadrid — üks kontaktleht JPG-na (üks klipp); keelab burn_ts.

clips

array

1–10 {start,end} ajavahemikku; üheks failiks ühendamiseks määra stitch.

stitch

boolean

Kui valitud on clips, liidetakse need üheks failiks — video, audio_only, both, short, nosound.

Idempotency-Key

header

Saadetakse HTTP päisena (≤ 200 tähemärki), mitte kehaväljana — korduskatsed kasutavad sama tööd.

Lõpp-punktid: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Bearer-autenditud.
GET /v1/download/{token}/{file} — autenditud URL-tokeniga, Bearer-päist ei kasutata.

Hinnad

Maksa klippide, mitte kohtade eest.

Ettemaksetud krediidid annavad jõudu AppsGolemi lõikuri API-le & MCP-serverile — üks valminud klipp maksab ühe krediidi ja ebaõnnestunud lõikamiste eest ei arveldata kunagi. Osta pakett juhuslikuks kasutuseks või telli püsiv igakuine maht ja kõrgem kiiruspiirang.

№ 01 / Ettemakstud paketid

Maksa vastavalt kasutusele.

Ühekordne ost, ei uuene automaatselt. Krediidid kehtivad 12 kuud.

Starterpakett

€5 ühekordne

25 krediiti · ≈ 25 tavaklippi

Kehtib 12 kuud

Alusta

PAYG-pakett Parim väärtus

€25 ühekordne

150 krediiti · ≈ 150 tavaklippi

Kehtib 12 kuud · €0,17 / krediit

Alusta

№ 02 / Tellimused

Lõika iga kuu.

Krediidid uuenevad iga perioodi järel ja sinu kiiruspiirang tõuseb. Tühista igal ajal.

Starter

€19 / kuu

või €190 / aasta · 2 kuud tasuta

250 krediiti / kuu

30 päringut / tund
Krediidid uuenevad igakuiselt
Tühista igal ajal

Alusta

★ Populaarseim Pro

€49 / kuu

või €490 / aasta · 2 kuud tasuta

1000 krediiti / kuu

60 päringut / tund
Krediidid uuenevad igakuiselt
Tühista igal ajal

Alusta

Scale

€149 / kuu

või €1490 / aasta · 2 kuud tasuta

5000 krediiti / kuu

120 päringut / tund
Krediidid uuenevad igakuiselt
Tühista igal ajal

Alusta

Tellimused annavad kogu perioodi krediidid ette ja tõstavad sinu päringute/tunnis piirmäära. Aastatellimuste eest arveldatakse 10 kuu, mitte 12 kuu eest.

№ 03 / Kuidas krediidid töötavad