API per a desenvolupadors · servidor MCP

Retalla clips de YouTube des del teu codi.

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

Una API REST senzilla i un servidor MCP per a agents d'AI — tot el que fa el retallador web, de manera programàtica. Crèdits prepagats, sense subscripció.

Obtén una clau d'API Inici ràpid

API + MCP per a agents de codi →

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

Com funciona

Ets nou aquí? Tot el model en un minut.

Compres crèdits prepagats, crees una clau d'API i crides un únic endpoint per retallar un clip. El retall és asíncron: envies un job, en consultes l'estat fins que es produeix, i després baixes el fitxer des d'una URL amb token. El servidor MCP encapsula tot això en una sola crida d'eina per a agents d'IA. Sense subscripció, sense places — pagues per cada clip produït.

1 · Autenticar-se

Envia la teva clau com a Authorization: Bearer ag_live_… a cada sol·licitud.

2 · Enviar i consultar

POST /v1/cuts retorna un id de job; consulta GET /v1/cuts/{id} fins que es produeixi.

3 · Baixa

Obtén el download_url del job produït — no cal cap capçalera, el token l'autoritza.

Inici ràpid

De zero a un clip en quatre crides.

01

Crea una clau API

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

Envia una sol·licitud de retall

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

Consulta l'URL de baixada

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

Els estats passen per accepted → queued → produced → delivered (o failed → refunded). Un clip curt sol estar llest en segons; consulta cada 3–5 s.

Els enllaços de descàrrega caduquen 72 hores després de generar-se el clip — descarrega'l dins d'aquest termini.

04

Baixa el clip

L'URL amb token transmet l'MP4 — reutilitzable fins que caduca. L'eina MCP cut_youtube_video fa els passos 2–4 per tu en una sola crida.

Per a agents d'AI · MCP

Una línia per a Claude, Cursor i Codex.

El servidor MCP exposa el retallador com a tres eines que qualsevol client MCP pot cridar. Instal·la'l amb npx — no cal instal·lar res globalment.

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

Envia un retall (qualsevol mode, opcions o una matriu de clips) i rep un URL de baixada.

get_cut_status()

Comprova una tasca per id i obtén el seu URL de baixada.

get_account_balance()

Els teus crèdits disponibles i el límit horari.

Què dir al teu agent — totes les funcionalitats

“Retallar de 0:30 a 1:15 d'un vídeo en 1080p”

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

“Extreure l'àudio d'aquest vídeo de 2:00–5:00 com a MP3 de 320 kbps”

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

“Exportar el vídeo i un MP3 dels primers 30 segons”

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

“Crear un short vertical 9:16 del moment destacat 10:00–10:45”

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

“Convertir 0:05–0:12 en un GIF”

cut_youtube_video(…, mode="gif")

“Extreure un contact sheet de fotogrames cada 5 segons de 1:00–2:00”

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

“Stitch 0:10–0:20 i 1:00–1:10 en un sol clip”

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

“Fer un tall fast en stream-copy dels primers 30 segons”

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

“Retallar 0:00–0:20 a una velocitat de 1.5×, en 4K”

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

“Quants crèdits d'API em queden?”

get_account_balance()

“Comprovar el job e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

L'agent emplena els paràmetres a partir de la teva sol·licitud — no escrius JSON.

Referència de l'API

Cada endpoint, amb exemples.

Quatre endpoints. Els tres endpoints de lectura/escriptura requereixen Authorization: Bearer <key>; l'URL de baixada està autoritzada pel seu propi token, així que no necessita cap capçalera.

POST /v1/cuts Bearer

Sol·licitud · video

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

Resposta · 202 Accepted

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

Indica start+end o un array clips (1–10 finestres). Afegeix una capçalera Idempotency-Key (≤200 caràcters) perquè una sol·licitud reintentada reutilitzi el mateix job en lloc de cobrar dues vegades.

Cos de la sol·licitud per mode

audio_onlymp3 · m4a · wav · flac

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

bothMP4 + MP3, en zip

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

short9:16 smart-crop per IA

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

nosoundMP4, sense àudio

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

gif≤ 5 min, un sol clip

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

framesImatges fixes JPG · ≤ 1800

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

clips + stitch1–10 → un sol fitxer

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

Resposta · 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 és un de: accepted · queued · produced · delivered · failed · refunded. download_url apareix quan un token està a punt — si no hi és, torna a consultar.

GET /v1/account Bearer

Resposta · 200

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

GET /v1/download/{token}/{file} Token a la URL

Resposta · 200

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

Sense capçalera Bearer — el token al camí l'autoritza. La URL és reutilitzable fins que caduca.

Errors

Cada error retorna un cos JSON amb un codi error i l'estat HTTP. Torna-ho a intentar amb un 429 després de retry_after segons; corregeix i torna a enviar en un 400.

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

Límit de taxa: Només les trameses de tall tenen limitació de freqüència — les trameses/hora del teu pla (vegeu Preus). Consultar el progrés d'una tasca no té limitació en ús normal, així que el sondeig mai no compta per a aquest límit. Respecta poll_after a cada resposta (i Retry-After en el rar cas d'un 429); l'eina MCP regula aquest ritme per tu amb wait=true.

Capacitats

Tots els modes que té el retallador web.

MODE video

MP4 fins a 4K

144p–2160p, 60fps, sense marca d'aigua.

MODE audio_only

Àudio

mp3 / m4a / wav / flac, taxa de bits seleccionable.

MODE both

Vídeo + àudio

MP4 i MP3 junts, en un zip.

MODE nosound

Vídeo silenciat

Vídeo sense la pista d'àudio.

MODE short

9:16 vertical

Retallat intel·ligent amb AI per a Shorts, Reels i TikTok; recorre a bandes negres difuminades quan no està disponible.

MODE gif

GIF animat

Fins a 5 minuts, directament des d'un clip.

MODE frames

Fotogrames JPG

Cada 100ms–10s, marques de temps + full de contacte.

OPTION fast

Mode ràpid

Còpia de flux (stream-copy), uns 10× més ràpida; manté el contenidor d'origen (WebM a 1440p/2160p).

OPTION speed

Velocitat 0.5–2×

Reajusta el temps de reproducció en exportar.

OPTION clips

Unió de diversos clips

Fins a 10 finestres unides en un sol fitxer.

Referència

Paràmetres

Camp

Tipus

Notes

url

string

URL de YouTube de visualització / compartició / youtu.be.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Omet-ho si s'utilitzen clips.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; retall total ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — només per a audio_only; both sempre és MP3.

bitrate

enum

Taxa de bits amb pèrdua 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); ignorada per a wav/flac.

fast

boolean

Stream-copy, uns 10× més ràpid — només video, nosound, both; força speed a 1×.

speed

number

Velocitat de reproducció 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Mostreig de fotogrames: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG en total.

burn_ts

boolean

Fotogrames — incrusta la marca horària d'origen a cada JPG.

sheet

boolean

Fotogrames — un únic JPG de full de contactes (un sol clip); desactiva burn_ts.

clips

array

1–10 finestres {start,end}; configura stitch per ajuntar-les en un sol fitxer.

stitch

boolean

Amb clips, els uneix en un sol fitxer — video, audio_only, both, short, nosound.

Idempotency-Key

header

S'envia com a capçalera HTTP (≤ 200 caràcters), no com a camp del cos — els reintents reutilitzen la mateixa tasca.

Punts finals: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Autenticat amb Bearer.
GET /v1/download/{token}/{file} — Autenticat mitjançant el token de l'URL, sense capçalera Bearer.

Preus

Paga per clips, no per seients.

Els crèdits prepagats alimenten l'API de retall d'AppsGolem & el servidor MCP — cada clip produït és un crèdit, i els retalls fallits mai es cobren. Compra un paquet per a ús ocasional, o subscriu-te per a un volum mensual constant i un límit de sol·licituds més alt.

№ 01 / Paquets prepagats

Paga segons l'ús.

Compra única, sense renovació. Els crèdits són vàlids durant 12 mesos.

Paquet inicial

€5 pagament únic

25 crèdits · ≈ 25 clips estàndard

Vàlid 12 mesos

Comença ara

Paquet PAYG Millor valor

€25 pagament únic

150 crèdits · ≈ 150 clips estàndard

Vàlid 12 mesos · €0,17 / crèdit

Comença ara

№ 02 / Subscripcions

Retalla cada mes.

Els crèdits es renoven cada període i el teu límit de sol·licituds augmenta. Cancel·la quan vulguis.

Inicial

€19 / mes

o €190 / any · 2 mesos gratis

250 crèdits / mes

30 sol·licituds / hora
Els crèdits es renoven mensualment
Cancel·la quan vulguis

Comença ara

★ Més popular Pro

€49 / mes

o €490 / any · 2 mesos gratis

1000 crèdits / mes

60 sol·licituds / hora
Els crèdits es renoven mensualment
Cancel·la quan vulguis

Comença ara

Escala

€149 / mes

o €1490 / any · 2 mesos gratis

5000 crèdits / mes

120 sol·licituds / hora
Els crèdits es renoven mensualment
Cancel·la quan vulguis

Comença ara

Les subscripcions atorguen per endavant els crèdits de tot el període i augmenten el teu límit de sol·licituds/hora. Els plans anuals cobren 10 mesos per 12.

№ 03 / Com funcionen els crèdits