Vývojářské API · MCP server

Střihejte klipy z YouTube z vašeho kódu.

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

Jednoduché REST API a MCP server pro AI agenty — vše, co dokáže webový střihač, programově. Předplacené kredity, žádné předplatné.

Získat API klíč Rychlý start

API + MCP pro kódovací agenty →

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

Jak to funguje

Poprvé tady? Celý model za minutu.

Koupíte předplacené kredity, vytvoříte API klíč a jedním voláním endpointu ořízněte klip. Stříhání je asynchronní: odešlete úlohu, opakovaně kontrolujete stav, dokud nedosáhne stavu produced, a pak stáhnete soubor z tokenizované URL. MCP server to celé zabalí do jediného volání nástroje pro AI agenty. Žádné předplatné, žádná místa — platíte za každý klip ve stavu produced.

1 · Ověření

Pošlete svůj klíč jako Authorization: Bearer ag_live_… v každém požadavku.

2 · Odeslání a kontrola stavu

POST /v1/cuts vrátí ID úlohy; kontrolujte stav přes GET /v1/cuts/{id}, dokud nedosáhne stavu produced.

3 · Stáhnout

Načtěte download_url z úlohy ve stavu produced — žádná hlavička není potřeba, autorizuje ji token.

Rychlý start

Od nuly ke klipu ve čtyřech voláních.

01

Vytvořit API klíč

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

Odeslat střih

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

Dotazovat se na URL ke stažení

# 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 (nebo failed → refunded). Krátký klip bývá hotový během pár sekund; kontrolujte stav každých 3–5 s.

Odkazy ke stažení vyprší 72 hodin po vytvoření klipu — stáhněte si ho v tomto časovém okně.

04

Stáhnout klip

Tokenizovaná URL streamuje MP4 — použitelná opakovaně, dokud nevyprší platnost. MCP nástroj cut_youtube_video za vás provede kroky 2–4 v jednom volání.

Pro AI agenty · MCP

Jeden řádek pro Claude, Cursor a Codex.

MCP server zpřístupňuje střihač jako tři nástroje, které může volat libovolný MCP klient. Nainstalujte pomocí npx — není třeba nic instalovat globálně.

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

Odešlete střih (libovolný režim, možnosti nebo pole clips) a získáte zpět URL ke stažení.

get_cut_status()

Zkontrolujte úlohu podle id a získejte její URL ke stažení.

get_account_balance()

Vaše dostupné kredity a hodinový limit.

Co říct svému agentovi — všechny možnosti

“Ořízni video od 0:30 do 1:15 v 1080p”

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

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

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

“Exportuj video a MP3 prvních 30 sekund”

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

“Vytvoř svislé short video 9:16 z vrcholu 10:00–10:45”

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

“Přeměň 0:05–0:12 na GIF”

cut_youtube_video(…, mode="gif")

“Extrahuj kontaktní sheet snímků každých 5 sekund 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 jednoho klipu”

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

“Udělej fast, stream-copy střih prvních 30 sekund”

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

“Ořízni 0:00–0:20 rychlostí 1.5×, v 4K”

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

“Kolik API kreditů mi zbývá?”

get_account_balance()

“Zkontroluj úlohu e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

Agent doplní parametry na základě vašeho požadavku — JSON nepíšete vy.

Reference API

Každý endpoint s příklady.

Čtyři endpointy. Tři endpointy pro čtení/zápis vyžadují Authorization: Bearer <key>; URL ke stažení je autorizována vlastním tokenem, takže nepotřebuje žádnou hlavičku.

POST /v1/cuts Bearer

Požadavek · video

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

Odpověď · 202 Accepted

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

Zadejte buď start+end, nebo pole clips (1–10 úseků). Přidejte hlavičku Idempotency-Key (≤200 znaků), aby opakovaný požadavek použil stejnou úlohu místo dvojího účtování.

Tělo požadavku podle 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 ZIPu

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

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

Odpověď · 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 hodnot accepted · queued · produced · delivered · failed · refunded. download_url se objeví, jakmile je token připravený — pokud chybí, zkontrolujte stav znovu.

GET /v1/account Bearer

Odpověď · 200

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

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

Odpověď · 200

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

Žádná Bearer hlavička — autorizuje ji token v cestě. URL je použitelná opakovaně, dokud nevyprší.

Chyby

Každé selhání vrátí JSON tělo s kódem error a HTTP stavem. Opakujte 429 po retry_after sekundách; při 400 opravte a odešlete znovu.

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

Omezení rychlosti: Omezení počtu požadavků platí pouze pro odeslání střihu — počet odeslání za hodinu závisí na vašem plánu (viz Ceník). Kontrola průběhu úlohy není při běžném použití omezena, takže dotazování se do tohoto limitu nikdy nezapočítává. V každé odpovědi respektujte hodnotu poll_after (a při vzácné chybě 429 hlavičku Retry-After); nástroj MCP to za vás automaticky řídí pomocí wait=true.

Možnosti

Každý režim, který webový střihač nabízí.

MODE video

MP4 až do 4K

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

MODE audio_only

Zvuk

mp3 / m4a / wav / flac, volitelný bitrate.

MODE both

Video + audio

MP4 a MP3 společně, jako zip.

MODE nosound

Video bez zvuku

Video bez zvukové stopy.

MODE short

9:16 na výšku

Chytrý AI ořez pro Shorts, Reels a TikTok; při nedostupnosti přejde na rozostřené orámování.

MODE gif

Animovaný GIF

Až 5 minut, přímo z klipu.

MODE frames

JPG snímky

Každých 100ms–10s, časové značky + kontaktní list.

OPTION fast

Rychlý režim

Stream-copy, přibližně 10× rychlejší; zachovává zdrojový kontejner (WebM při 1440p/2160p).

OPTION speed

Rychlost 0.5–2×

Upravte tempo přehrávání při exportu.

OPTION clips

Spojení více klipů

Až 10 úseků spojených do jednoho souboru.

Reference

Parametry

Pole

Typ

Poznámky

url

string

YouTube watch / share / youtu.be URL.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Vynechte při použití clips.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; celkový střih ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — pouze pro audio_only; both je vždy MP3.

bitrate

enum

Ztrátový bitrate 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); ignorováno pro wav/flac.

fast

boolean

Stream-copy, přibližně 10× rychlejší — pouze video, nosound, both; vynucuje speed na 1×.

speed

number

Rychlost přehrávání 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Vzorkování snímků: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG celkem.

burn_ts

boolean

Snímky — vypálí časové razítko zdroje na každý JPG.

sheet

boolean

Snímky — jeden kontaktní list JPG (jeden klip); vypíná burn_ts.

clips

array

1–10 {start,end} úseků; nastavte stitch pro spojení do jednoho souboru.

stitch

boolean

S clips je spojí do jednoho souboru — video, audio_only, both, short, nosound.

Idempotency-Key

header

Odesíláno jako hlavička HTTP (≤ 200 znaků), nikoli jako pole těla požadavku — opakované pokusy použijí stejnou úlohu.

Endpointy: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Ověřeno přes Bearer.
GET /v1/download/{token}/{file} — Ověřeno tokenem v URL, bez hlavičky Bearer.

Ceník

Plaťte za klipy, ne za uživatele.

Předplacené kredity pohánějí API stříhacího nástroje AppsGolem & server MCP — jeden vytvořený klip je jeden kredit a neúspěšné střihy nejsou nikdy účtovány. Kupte balíček pro příležitostné použití, nebo si předplaťte stálý měsíční objem a vyšší limit rychlosti.

№ 01 / Předplacené balíčky