API pre vývojárov · MCP server

Strihajte klipy z YouTubu priamo z vášho kódu.

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

Jednoduché REST API a MCP server pre AI agentov — všetko, čo robí webový nástroj, ale programovo. Predplatené kredity, žiadne predplatné.

Získať API kľúč Rýchly štart

API + MCP pre kódovacích agentov →

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

Ako to funguje

Prvýkrát tu? Celý model za minútu.

Kúpite si predplatené kredity, vytvoríte API kľúč a jedným volaním endpointu orežete klip. Strihanie je asynchrónne: odošlete úlohu, opakovane kontrolujete stav, kým nedosiahne stavu produced, a potom stiahnete súbor z tokenizovanej URL. MCP server to všetko zabalí do jedného volania nástroja pre AI agentov. Žiadne predplatné, žiadne miesta — platíte za každý klip v stave produced.

1 · Overenie

Pošlite svoj kľúč ako Authorization: Bearer ag_live_… v každej požiadavke.

2 · Odoslanie a kontrola stavu

POST /v1/cuts vráti ID úlohy; kontrolujte stav cez GET /v1/cuts/{id}, kým nedosiahne stavu produced.

3 · Stiahnuť

Načítajte download_url z úlohy v stave produced — žiadna hlavička nie je potrebná, autorizuje ju token.

Rýchly štart

Od nuly ku klipu za štyri volania.

01

Vytvorte API kľúč

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

Odošlite požiadavku na strih

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

Zisťujte URL na stiahnutie

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

Stavy postupujú accepted → queued → produced → delivered (alebo failed → refunded). Krátky klip býva hotový v priebehu pár sekúnd; kontrolujte stav každých 3–5 s.

Odkazy na stiahnutie vypršia 72 hodín po vytvorení klipu — stiahnite si ho v tomto časovom okne.

04

Stiahnite klip

Tokenizovaná URL streamuje MP4 — dá sa opakovane použiť až do vypršania platnosti. Nástroj MCP cut_youtube_video vykoná kroky 2–4 za vás v jednom volaní.

Pre AI agentov · MCP

Jeden riadok pre Claude, Cursor a Codex.

MCP server sprístupňuje strih ako tri nástroje, ktoré môže volať ľubovoľný MCP klient. Nainštalujte pomocou npx — netreba nič inštalovať globálne.

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

Odošlite požiadavku na strih (ľubovoľný režim, možnosti alebo pole clips) a získajte späť URL na stiahnutie.

get_cut_status()

Skontrolujte úlohu podľa ID a získajte jej URL na stiahnutie.

get_account_balance()

Vaše dostupné kredity a hodinový limit.

Čo povedať svojmu agentovi — všetky možnosti

“Orež video od 0:30 do 1:15 v 1080p”

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

“Získaj zvuk toho videa od 2:00–5:00 ako 320 kbps MP3”

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

“Exportuj video a MP3 prvých 30 sekúnd”

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

“Vytvor zvislé short video 9:16 z vrcholu 10:00–10:45”

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

“Zmeň 0:05–0:12 na GIF”

cut_youtube_video(…, mode="gif")

“Extrahuj kontaktný sheet snímok každých 5 sekúnd od 1:00–2:00”

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

“Stitch 0:10–0:20 a 1:00–1:10 do jedného klipu”

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

“Urob fast, stream-copy strih prvých 30 sekúnd”

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

“Orež 0:00–0:20 rýchlosťou 1.5×, v 4K”

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

“Koľko API kreditov mi zostáva?”

get_account_balance()

“Skontroluj úlohu e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

Agent doplní parametre na základe vašej požiadavky — JSON nepíšete vy.

Referencia API

Každý endpoint s príkladmi.

Štyri endpointy. Tri endpointy na čítanie/zápis vyžadujú Authorization: Bearer <key>; URL na stiahnutie je autorizovaná vlastným tokenom, takže nepotrebuje žiadnu hlavičku.

POST /v1/cuts Bearer

Požiadavka · video

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

Odpoveď · 202 Accepted

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

Zadajte buď start+end, alebo pole clips (1–10 úsekov). Pridajte hlavičku Idempotency-Key (≤200 znakov), aby opakovaná požiadavka použila rovnakú úlohu namiesto dvojitého účtovania.

Telo požiadavky podľa režimu

audio_onlymp3 · m4a · wav · flac

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

bothMP4 + MP3, v ZIPe

{ "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, bez zvuku

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

gif≤ 5 min, jeden klip

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

framesJPG snímky · ≤ 1800

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

clips + stitch1–10 → jeden súbor

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

Odpoveď · 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 je jedna z hodnôt accepted · queued · produced · delivered · failed · refunded. download_url sa objaví, hneď ako je token pripravený — ak chýba, skontrolujte stav znova.

GET /v1/account Bearer

Odpoveď · 200

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

GET /v1/download/{token}/{file} Token v URL

Odpoveď · 200

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

Žiadna Bearer hlavička — autorizuje ju token v ceste. URL je možné použiť opakovane, kým nevyprší.

Chyby

Každé zlyhanie vráti JSON telo s kódom error a HTTP stavom. Opakujte 429 po retry_after sekundách; pri 400 opravte a odošlite znova.

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

Obmedzenie rýchlosti: Obmedzenie počtu požiadaviek sa vzťahuje iba na odoslania strihu — počet odoslaní za hodinu závisí od vášho plánu (pozri Cenník). Kontrola priebehu úlohy nie je pri bežnom používaní obmedzená, takže dopytovanie sa do tohto limitu nikdy nezapočítava. V každej odpovedi rešpektujte hodnotu poll_after (a pri zriedkavej chybe 429 hlavičku Retry-After); nástroj MCP to za vás automaticky rieši pomocou wait=true.

Možnosti

Všetky režimy, ktoré ponúka webový nástroj.

MODE video

MP4 až do 4K

144p–2160p, 60fps, bez vodoznaku.

MODE audio_only

Zvuk

mp3 / m4a / wav / flac, voliteľný bitrate.

MODE both

Video + audio

MP4 a MP3 spolu, ako zip.

MODE nosound

Video bez zvuku

Video bez zvukovej stopy.

MODE short

9:16 na výšku

Inteligentné orezanie pomocou AI pre Shorts, Reels a TikTok; ak nie je k dispozícii, prejde na rozmazané orámovanie.

MODE gif

Animovaný GIF

Až 5 minút, priamo z klipu.

MODE frames

Snímky JPG

Každých 100ms–10s, časové značky + kontaktný hárok.

OPTION fast

Rýchly režim

Stream-copy, približne 10× rýchlejšie; zachováva zdrojový kontajner (WebM pri 1440p/2160p).

OPTION speed

Rýchlosť 0.5–2×

Zmena tempa prehrávania pri exporte.

OPTION clips

Spojenie viacerých klipov

Až 10 úsekov spojených do jedného súboru.

Referencia

Parametre

Pole

Typ

Poznámky

url

string

YouTube watch / share / youtu.be URL.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Vynechajte pri použití clips.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; celková dĺžka strihu ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — len pre audio_only; both je vždy MP3.

bitrate

enum

Stratový bitrate 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); ignorované pre wav/flac.

fast

boolean

Stream-copy, približne 10× rýchlejšie — iba video, nosound, both; vynucuje speed na 1×.

speed

number

Rýchlosť prehrávania 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Vzorkovanie snímok: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG celkovo.

burn_ts

boolean

Snímky — vypáli časovú značku zdroja na každý JPG.

sheet

boolean

Snímky — jeden kontaktný hárok JPG (jeden klip); vypína burn_ts.

clips

array

1–10 úsekov {start,end}; nastavte stitch na spojenie do jedného súboru.

stitch

boolean

S clips ich spojí do jedného súboru — video, audio_only, both, short, nosound.

Idempotency-Key

header

Odosiela sa ako hlavička HTTP (≤ 200 znakov), nie ako pole tela — opakované pokusy použijú tú istú úlohu.

Endpointy: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Autentifikované cez Bearer.
GET /v1/download/{token}/{file} — autentifikované tokenom v URL, bez hlavičky Bearer.

Ceny

Platíte za klipy, nie za miesta.

Predplatené kredity poháňajú API strihacieho nástroja AppsGolem & server MCP — jeden vytvorený klip je jeden kredit a neúspešné strihy sa nikdy neúčtujú. Kúpte balík pre príležitostné použitie, alebo si predplaťte stály mesačný objem a vyšší limit rýchlosti.

№ 01 / Predplatené balíky