Kūrėjų API · MCP serveris

Iškirpkite YouTube klipus iš savo kodo.

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

Paprastas REST API ir MCP serveris AI agentams — viskas, ką atlieka žiniatinklio pjaustyklė, tik programiškai. Iš anksto apmokami kreditai, jokios prenumeratos.

Gauti API raktą Greitas startas

API + MCP programavimo agentams →

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

Kaip tai veikia

Pirmą kartą čia? Visas modelis per minutę.

Tu perki iš anksto apmokėtus kreditus, susikuri API raktą ir iškviesi vieną galinį tašką, kad iškirptum klipą. Kirpimas yra asinchroninis: pateiki užduotį, tikrini būseną, kol ji bus paruošta, tada atsisiunti failą pagal tokenizuotą URL. MCP serveris viską tai supakuoja į vieną įrankio iškvietimą DI agentams. Jokios prenumeratos, jokių vietų — moki už kiekvieną paruoštą klipą.

1 · Autentifikuotis

Su kiekviena užklausa siųsk savo raktą kaip Authorization: Bearer ag_live_….

2 · Pateikti ir tikrinti

POST /v1/cuts grąžina užduoties id; tikrink GET /v1/cuts/{id}, kol ji bus paruošta.

3 · Atsisiųsti

Gauk download_url iš paruoštos užduoties — antraštės nereikia, nes ją autorizuoja pats tokenas.

Greitas startas

Nuo nulio iki klipo per keturis iškvietimus.

01

Sukurkite API raktą

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

Pateikite pjūvį

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

Tikrinkite atsisiuntimo URL

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

Būsenos keičiasi taip: accepted → queued → produced → delivered (arba failed → refunded). Trumpas klipas paprastai paruošiamas per kelias sekundes; tikrink kas 3–5 s.

Atsisiuntimo nuorodos galioja 72 valandas nuo klipo sukūrimo — atsisiųskite jį per šį laikotarpį.

04

Atsisiųskite klipą

URL su prieigos raktu transliuoja MP4 failą — jį galima naudoti pakartotinai, kol nesibaigė jo galiojimas. MCP įrankis cut_youtube_video atlieka 2–4 žingsnius vienu iškvietimu.

AI agentams · MCP

Viena eilutė, tinkanti Claude, Cursor ir Codex.

MCP serveris pateikia pjaustyklę kaip tris įrankius, kuriuos gali iškviesti bet kuris MCP klientas. Diekite naudodami npx — nieko nereikia diegti visuotinai.

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

Pateikite pjūvį (bet kokį režimą, parinktis arba clips masyvą) ir gaukite atsisiuntimo URL.

get_cut_status()

Patikrinkite užduotį pagal id ir gaukite jos atsisiuntimo URL.

get_account_balance()

Jūsų išleidžiami kreditai ir valandinė riba.

Ką pasakyti savo agentui — visos galimybės

“Kirpk vaizdo įrašo dalį nuo 0:30 iki 1:15 1080p kokybe”

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

“Ištrauk to vaizdo įrašo garsą nuo 2:00–5:00 kaip 320 kbps MP3”

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

“Eksportuok vaizdo įrašą ir pirmų 30 sekundžių MP3”

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

“Sukurk 9:16 vertikalų klipą iš 10:00–10:45 akimirkos”

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

“Paversk 0:05–0:12 į GIF”

cut_youtube_video(…, mode="gif")

“Sukurk kadrų contact sheet kas 5 sekundes nuo 1:00–2:00”

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

“Stitch 0:10–0:20 ir 1:00–1:10 į vieną klipą”

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

“Padaryk fast, stream-copy tipo iškarpą iš pirmų 30 sekundžių”

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

“Iškirpk 0:00–0:20 1.5× greičiu, 4K kokybe”

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

“Kiek man liko API kreditų?”

get_account_balance()

“Patikrink užduoties e48d…b1a2 būseną”

get_cut_status(job_id="e48d…b1a2")

Agentas pats užpildo parametrus pagal tavo užklausą — tau nereikia rašyti JSON.

API dokumentacija

Kiekvienas galinis taškas su pavyzdžiais.

Keturi galiniai taškai. Trys skaitymo/rašymo galiniai taškai reikalauja Authorization: Bearer <key>; atsisiuntimo URL autorizuojamas savo paties tokenu, todėl antraštės nereikia.

POST /v1/cuts Bearer

Užklausa · video

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

Atsakymas · 202 Accepted

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

Nurodyk arba start+end, arba clips masyvą (1–10 intervalų). Pridėk Idempotency-Key antraštę (≤200 simbolių), kad pakartota užklausa panaudotų tą pačią užduotį, o ne būtų apmokestinta du kartus.

Užklausos turinys pagal režimą

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 archyve

{ "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, be garso

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

gif≤ 5 min, vienas klipas

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

framesJPG kadrai · ≤ 1800

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

clips + stitch1–10 → vienas failas

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

Atsakymas · 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 būna viena iš: accepted · queued · produced · delivered · failed · refunded. download_url atsiranda, kai tokenas paruoštas — jei jo nėra, tikrink dar kartą.

GET /v1/account Bearer

Atsakymas · 200

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

GET /v1/download/{token}/{file} Prieigos raktas URL adrese

Atsakymas · 200

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

Bearer antraštės nereikia — kelyje esantis raktas jį autorizuoja. URL galima naudoti pakartotinai, kol jis nepasibaigęs.

Klaidos

Kiekviena nesėkmė grąžina JSON turinį su error kodu ir HTTP būsena. Kartok 429 po retry_after sekundžių; jei gavai 400, ištaisyk ir pateik iš naujo.

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

Užklausų limitas: Greičio ribojimas taikomas tik pjovimo pateikimams — pateikimų skaičius per valandą priklauso nuo jūsų plano (žr. Kainodara). Užduoties eigos tikrinimas įprastinio naudojimo metu nėra ribojamas, todėl periodiškas būsenos tikrinimas niekada neįskaičiuojamas į šią ribą. Kiekviename atsakyme atsižvelkite į reikšmę poll_after (o retos 429 klaidos atveju — į antraštę Retry-After); MCP įrankis tai už jus automatiškai sureguliuoja naudodamas wait=true.

Galimybės

Visi žiniatinklio pjaustyklės režimai.

MODE video

MP4 iki 4K

144p–2160p, 60fps, be vandens ženklo.

MODE audio_only

Garsas

mp3 / m4a / wav / flac, pasirenkama bitų sparta.

MODE both

Vaizdas + garsas

MP4 ir MP3 kartu, kaip zip failas.

MODE nosound

Vaizdo įrašas be garso

Vaizdo įrašas be garso takelio.

MODE short

9:16 vertikalus

AI išmanusis apkarpymas, skirtas Shorts, Reels ir TikTok; kai tai nepasiekiama, naudojamas suliejimo efektas su juostomis.

MODE gif

Animuotas GIF

Iki 5 minučių, tiesiai iš klipo.

MODE frames

JPG kadrai

Kas 100ms–10s, laiko žymos + kontaktinis lapas.

OPTION fast

Greitasis režimas

Stream-copy, maždaug 10× greičiau; išsaugomas originalus konteineris (WebM esant 1440p/2160p raiškai).

OPTION speed

Greitis 0.5–2×

Pritaikykite atkūrimo greitį eksportuojant.

OPTION clips

Kelių klipų sujungimas

Iki 10 intervalų, sujungtų į vieną failą.

Žinynas

Parametrai

Laukas

Tipas

Pastabos

url

string

YouTube watch / share / youtu.be URL.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Praleiskite, jei naudojate clips.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; bendra pjūvio trukmė ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — tik audio_only režimui; both visada yra MP3.

bitrate

enum

Nuostolinga bitų sparta 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); netaikoma wav/flac.

fast

boolean

Srauto kopijavimas, apie 10× greičiau — tik video, nosound, both; priverstinai nustato greitį į 1×.

speed

number

Atkūrimo greitis 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Kadrų ėmimas: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG iš viso.

burn_ts

boolean

Kadrai — įdega šaltinio laiko žymą į kiekvieną JPG.

sheet

boolean

Kadrai — vienas kontaktinio lapo JPG failas (vienas klipas); išjungia burn_ts.

clips

array

1–10 {start,end} intervalų; norėdami sujungti į vieną failą, nustatykite stitch.

stitch

boolean

Kai naudojami clips, sujunkite juos į vieną failą — video, audio_only, both, short, nosound.

Idempotency-Key

header

Siunčiama kaip HTTP antraštė (≤ 200 simbolių), o ne užklausos turinio laukas — pakartotiniai bandymai naudoja tą pačią užduotį.

Galiniai taškai: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Autentifikuojama naudojant Bearer.
GET /v1/download/{token}/{file} — autentifikuojama URL raktu, be Bearer antraštės.

Kainos

Mokėkite už klipus, ne už vietas.

Iš anksto apmokėti kreditai maitina AppsGolem pjovimo įrankio API & MCP serverį — vienas sukurtas fragmentas yra vienas kreditas, o nepavykę pjūviai niekada neapmokestinami. Pirkite paketą retkarčiais naudojant arba užsisakykite pastovų mėnesinį kiekį ir didesnę greičio ribą.

№ 01 / Iš anksto apmokėti paketai