API pentru dezvoltatori · server MCP

Decupează clipuri YouTube direct din codul tău.

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

Un API REST simplu și un server MCP pentru agenți AI — tot ce face decupatorul web, dar programatic. Credite preplătite, fără abonament.

Obține o cheie API Pornire rapidă

API + MCP pentru agenți de programare →

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

Cum funcționează

Ești nou aici? Tot modelul, într-un minut.

Cumperi credite preplătite, creezi o cheie API și apelezi un singur endpoint pentru a decupa un clip. Decuparea este asincronă: trimiți un job, verifici starea până este produs, apoi descarci fișierul de la un URL cu token. Serverul MCP înfășoară toate acestea într-un singur apel de instrument pentru agenți de IA. Fără abonament, fără locuri — plătești pentru fiecare clip produs.

1 · Autentificare

Trimite cheia ta ca Authorization: Bearer ag_live_… la fiecare cerere.

2 · Trimitere și verificare

POST /v1/cuts returnează un id de job; verifică GET /v1/cuts/{id} până este produs.

3 · Descarcă

Preia download_url din job-ul produs — nu este nevoie de niciun header, token-ul îl autorizează.

Pornire rapidă

De la zero la un clip în patru apeluri.

01

Creează o cheie 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

Trimite o cerere de decupare

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

Verifică periodic URL-ul de descărcare

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

Stările trec prin accepted → queued → produced → delivered (sau failed → refunded). Un clip scurt este de obicei gata în câteva secunde; verifică la fiecare 3–5 s.

Linkurile de descărcare expiră la 72 de ore de la generarea clipului — descărcați-l în acest interval.

04

Descarcă clipul

URL-ul cu token transmite MP4-ul — reutilizabil până expiră. Instrumentul MCP cut_youtube_video realizează pentru tine pașii 2–4 într-un singur apel.

Pentru agenți AI · MCP

O linie pentru Claude, Cursor și Codex.

Serverul MCP expune decupatorul ca trei instrumente pe care le poate apela orice client MCP. Instalează cu npx — nimic de instalat global.

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

Trimite o decupare (orice mod, opțiuni sau un array clips) și primești înapoi un URL de descărcare.

get_cut_status()

Verifică o sarcină după id și obține URL-ul ei de descărcare.

get_account_balance()

Creditele tale disponibile și limita orară.

Ce să-i spui agentului tău — toate funcțiile

“Decupează de la 0:30 la 1:15 dintr-un videoclip în 1080p”

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

“Extrage audio din acel videoclip din 2:00–5:00 ca MP3 la 320 kbps”

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

“Exportă videoclipul și un MP3 al primelor 30 de secunde”

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

“Creează un short vertical 9:16 din cel mai bun moment 10:00–10:45”

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

“Transformă 0:05–0:12 într-un GIF”

cut_youtube_video(…, mode="gif")

“Extrage un contact sheet cu cadre la fiecare 5 secunde din 1:00–2:00”

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

“Stitch 0:10–0:20 și 1:00–1:10 într-un singur clip”

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

“Fă o tăiere fast, stream-copy, a primelor 30 de secunde”

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

“Decupează 0:00–0:20 la o viteză de 1.5×, în 4K”

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

“Câte credite API mi-au mai rămas?”

get_account_balance()

“Verifică job-ul e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

Agentul completează parametrii pe baza cererii tale — nu scrii JSON.

Referință API

Fiecare endpoint, cu exemple.

Patru endpoint-uri. Cele trei endpoint-uri de citire/scriere necesită Authorization: Bearer <key>; URL-ul de descărcare este autorizat de propriul token, deci nu are nevoie de niciun header.

POST /v1/cuts Bearer

Cerere · video

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

Răspuns · 202 Accepted

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

Trimite fie start+end, fie un array clips (1–10 ferestre). Adaugă un header Idempotency-Key (≤200 caractere) astfel încât o cerere retrimisă să refolosească același job în loc să taxeze de două ori.

Corpul cererii pe mod

audio_onlymp3 · m4a · wav · flac

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

bothMP4 + MP3, arhivate zip

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

short9:16 smart-crop cu IA

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

nosoundMP4, fără audio

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

gif≤ 5 min, un singur clip

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

framesImagini fixe JPG · ≤ 1800

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

clips + stitch1–10 → un singur fișier

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

Răspuns · 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 este unul dintre: accepted · queued · produced · delivered · failed · refunded. download_url apare de îndată ce un token este gata — dacă lipsește, verifică din nou.

GET /v1/account Bearer

Răspuns · 200

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

GET /v1/download/{token}/{file} Token în URL

Răspuns · 200

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

Fără header Bearer — token-ul din cale îl autorizează. URL-ul este reutilizabil până expiră.

Erori

Fiecare eșec returnează un corp JSON cu un cod error și starea HTTP. Reîncearcă un 429 după retry_after secunde; corectează și retrimite la 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

Limită de rată: Doar trimiterile de tăiere au limită de frecvență — numărul de trimiteri/oră al planului tău (vezi Prețuri). Verificarea progresului unei sarcini nu are limită de frecvență în uz normal, așa că interogarea periodică nu contează niciodată în acea limită. Respectă poll_after în fiecare răspuns (și Retry-After în rarul caz al unui 429); instrumentul MCP reglează acest ritm pentru tine cu wait=true.

Capacități

Toate modurile pe care le are decupatorul web.

MODE video

MP4 până la 4K

144p–2160p, 60fps, fără filigran.

MODE audio_only

Audio

mp3 / m4a / wav / flac, bitrate selectabil.

MODE both

Video + audio

MP4 și MP3 împreună, într-un zip.

MODE nosound

Video fără sunet

Video fără pista audio.

MODE short

9:16 vertical

Decupare inteligentă AI pentru Shorts, Reels și TikTok; recurge la benzi negre neclare când nu este disponibilă.

MODE gif

GIF animat

Până la 5 minute, direct dintr-un clip.

MODE frames

Cadre JPG

La fiecare 100ms–10s, marcaje de timp + planșă de contact.

OPTION fast

Mod rapid

Copiere de flux (stream-copy), de aproximativ 10× mai rapidă; păstrează containerul sursă (WebM la 1440p/2160p).

OPTION speed

Viteză 0.5–2×

Ajustează ritmul redării la export.

OPTION clips

Îmbinare multi-clip

Până la 10 intervale unite într-un singur fișier.

Referință

Parametri

Câmp

Tip

Note

url

string

URL YouTube watch / share / youtu.be.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Omite atunci când folosești clips.

resolution

enum

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

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — doar pentru audio_only; both este întotdeauna MP3.

bitrate

enum

Rată de biți cu pierderi 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); ignorată pentru wav/flac.

fast

boolean

Stream-copy, aproximativ 10× mai rapid — doar video, nosound, both; forțează speed la 1×.

speed

number

Viteză de redare 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Eșantionare cadre: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG în total.

burn_ts

boolean

Cadre — imprimă marcajul de timp al sursei pe fiecare JPG.

sheet

boolean

Cadre — o singură planșă de contact JPG (un singur clip); dezactivează burn_ts.

clips

array

1–10 intervale {start,end}; setează stitch pentru a le uni într-un singur fișier.

stitch

boolean

Cu clips, le unește într-un singur fișier — video, audio_only, both, short, nosound.

Idempotency-Key

header

Trimis ca antet HTTP (≤ 200 de caractere), nu ca câmp în corp — reîncercările reutilizează aceeași sarcină.

Endpointuri: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Autentificat prin Bearer.
GET /v1/download/{token}/{file} — autentificat prin tokenul din URL, fără antet Bearer.

Prețuri

Plătești pentru clipuri, nu pentru licențe.

Creditele preplătite alimentează API-ul de decupare AppsGolem & serverul MCP — fiecare clip produs înseamnă un credit, iar decupările eșuate nu sunt niciodată facturate. Cumpără un pachet pentru utilizare ocazională, sau abonează-te pentru un volum lunar constant și o limită de cereri mai mare.

№ 01 / Pachete preplătite

Plătește pe măsură ce consumi.

Achiziție unică, fără reînnoire. Creditele rămân valabile timp de 12 luni.

Pachet Starter

€5 plată unică

25 credite · ≈ 25 clipuri standard

Valabil 12 luni

Începeți

Pachet PAYG Cea mai bună valoare

€25 plată unică

150 credite · ≈ 150 clipuri standard

Valabil 12 luni · €0,17 / credit

Începeți

№ 02 / Abonamente

Decupează în fiecare lună.

Creditele se reînnoiesc la fiecare perioadă, iar limita ta de cereri crește. Anulează oricând.

Starter

€19 / lună

sau €190 / an · 2 luni gratuite

250 credite / lună

30 cereri / oră
Creditele se reînnoiesc lunar
Anulează oricând

Începeți

★ Cel mai popular Pro

€49 / lună

sau €490 / an · 2 luni gratuite

1000 credite / lună

60 cereri / oră
Creditele se reînnoiesc lunar
Anulează oricând

Începeți

Scale

€149 / lună

sau €1490 / an · 2 luni gratuite

5000 credite / lună

120 cereri / oră
Creditele se reînnoiesc lunar
Anulează oricând

Începeți

Abonamentele acordă în avans creditele pentru întreaga perioadă și îți cresc limita de cereri/oră. Planurile anuale se facturează pentru 10 luni din 12.

№ 03 / Cum funcționează creditele