API per sviluppatori · Server MCP

Taglia clip di YouTube direttamente dal tuo codice.

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

Una semplice API REST e un server MCP per agenti AI — tutto ciò che fa il cutter web, in modo programmatico. Crediti prepagati, nessun abbonamento.

Ottieni una chiave API Avvio rapido

API + MCP per agenti di coding →

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

Come funziona

Sei nuovo qui? Tutto il modello in un minuto.

Acquisti crediti prepagati, crei una chiave API e chiami un singolo endpoint per tagliare una clip. Il taglio è asincrono: invii un job, controlli lo stato finché non viene prodotto, poi scarichi il file da un URL con token. Il server MCP racchiude tutto questo in un'unica chiamata di strumento per gli agenti IA. Nessun abbonamento, nessun posto — paghi per ogni clip prodotta.

1 · Autenticarsi

Invia la tua chiave come Authorization: Bearer ag_live_… a ogni richiesta.

2 · Inviare e interrogare

POST /v1/cuts restituisce un id del job; interroga GET /v1/cuts/{id} finché non viene prodotto.

3 · Download

Recupera il download_url dal job prodotto — nessun header necessario, il token lo autorizza.

Avvio rapido

Da zero a una clip in quattro chiamate.

01

Crea una chiave 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

Invia un taglio

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

Interroga l'URL di download

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

Gli stati passano da accepted → queued → produced → delivered (o failed → refunded). Una clip breve è di solito pronta in pochi secondi; interroga ogni 3–5 s.

I link di download scadono 72 ore dopo la creazione della clip — la scarichi entro questo periodo.

04

Scarica la clip

L'URL tokenizzato trasmette l'MP4 in streaming — riutilizzabile fino alla scadenza. Lo strumento MCP cut_youtube_video esegue per te i passaggi 2–4 in un'unica chiamata.

Per agenti AI · MCP

Una riga per Claude, Cursor e Codex.

Il server MCP espone il cutter come tre strumenti richiamabili da qualsiasi client MCP. Installa con npx — niente da installare globalmente.

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

Invia un taglio (qualsiasi modalità, opzioni o un array clips) e ricevi in cambio un URL di download.

get_cut_status()

Controlla un job tramite id e recupera il suo URL di download.

get_account_balance()

I tuoi crediti spendibili e il limite orario.

Cosa dire al tuo agente — tutte le funzionalità

“Tagliare da 0:30 a 1:15 di un video in 1080p”

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

“Estrarre l'audio di quel video da 2:00–5:00 come MP3 a 320 kbps”

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

“Esportare il video e un MP3 dei primi 30 secondi”

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

“Creare uno short verticale 9:16 del momento clou 10:00–10:45”

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

“Trasformare 0:05–0:12 in una GIF”

cut_youtube_video(…, mode="gif")

“Estrarre un contact sheet di fotogrammi ogni 5 secondi da 1:00–2:00”

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

“Stitch 0:10–0:20 e 1:00–1:10 in un'unica clip”

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

“Eseguire un taglio fast in stream-copy dei primi 30 secondi”

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

“Tagliare 0:00–0:20 a una velocità di 1.5×, in 4K”

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

“Quanti crediti API mi restano?”

get_account_balance()

“Controllare il job e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

L'agente compila i parametri a partire dalla tua richiesta — non scrivi JSON.

Riferimento API

Ogni endpoint, con esempi.

Quattro endpoint. I tre endpoint di lettura/scrittura richiedono Authorization: Bearer <key>; l'URL di download è autorizzato dal proprio token, quindi non necessita di alcun header.

POST /v1/cuts Bearer

Richiesta · video

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

Risposta · 202 Accepted

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

Passa start+end oppure un array clips (1–10 finestre). Aggiungi un header Idempotency-Key (≤200 caratteri) in modo che una richiesta ripetuta riutilizzi lo stesso job invece di addebitare due volte.

Corpo della richiesta per modalità

audio_onlymp3 · m4a · wav · flac

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

bothMP4 + MP3, in zip

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

short9:16 smart-crop con IA

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

nosoundMP4, senza audio

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

gif≤ 5 min, una sola clip

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

framesImmagini fisse JPG · ≤ 1800

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

clips + stitch1–10 → un solo file

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

Risposta · 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 è uno tra accepted · queued · produced · delivered · failed · refunded. download_url compare quando un token è pronto — se è assente, interroga di nuovo.

GET /v1/account Bearer

Risposta · 200

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

GET /v1/download/{token}/{file} Token nell'URL

Risposta · 200

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

Nessun header Bearer — il token nel percorso lo autorizza. L'URL è riutilizzabile fino alla scadenza.

Errori

Ogni errore restituisce un corpo JSON con un codice error e lo stato HTTP. Riprova un 429 dopo retry_after secondi; correggi e reinvia in caso di 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

Limite di frequenza: Solo le richieste di taglio sono soggette a limite di frequenza — le richieste/ora del tuo piano (vedi Prezzi). Controllare l'avanzamento di un lavoro non è soggetto a limiti in condizioni d'uso normali, quindi il polling non conta mai ai fini di quel limite. Rispetta poll_after in ogni risposta (e Retry-After nel raro caso di un 429); lo strumento MCP gestisce questo ritmo per te con wait=true.

Funzionalità

Tutte le modalità del cutter web.

MODE video

MP4 fino a 4K

144p–2160p, 60fps, senza watermark.

MODE audio_only

Audio

mp3 / m4a / wav / flac, bitrate selezionabile.

MODE both

Video + audio

MP4 e MP3 insieme, in uno zip.

MODE nosound

Video senza audio

Video senza la traccia audio.

MODE short

Verticale 9:16

Ritaglio intelligente AI per Shorts, Reels e TikTok; ricorre a bande nere sfocate quando non disponibile.

MODE gif

GIF animata

Fino a 5 minuti, direttamente da una clip.

MODE frames

Fotogrammi JPG

Ogni 100ms–10s, timestamp + contact sheet.

OPTION fast

Modalità rapida

Copia diretta dello stream (stream-copy), circa 10× più veloce; mantiene il contenitore di origine (WebM a 1440p/2160p).

OPTION speed

Velocità 0.5–2×

Modifica la velocità di riproduzione durante l'esportazione.

OPTION clips

Unione multi-clip

Fino a 10 segmenti uniti in un unico file.

Riferimento

Parametri

Campo

Tipo

Note

url

string

URL YouTube watch / share / youtu.be.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). Ometti se usi clips.

resolution

enum

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

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — solo per audio_only; both è sempre MP3.

bitrate

enum

Bitrate con perdita 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); ignorato per wav/flac.

fast

boolean

Stream-copy, circa 10× più veloce — solo video, nosound, both; forza speed a 1×.

speed

number

Velocità di riproduzione 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Campionamento fotogrammi: 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG in totale.

burn_ts

boolean

Fotogrammi — incide il timestamp sorgente su ogni JPG.

sheet

boolean

Fotogrammi — un unico JPG contact-sheet (clip singola); disattiva burn_ts.

clips

array

1–10 segmenti {start,end}; imposta stitch per unirli in un unico file.

stitch

boolean

Con clips, uniti in un unico file — video, audio_only, both, short, nosound.

Idempotency-Key

header

Inviato come header HTTP (≤ 200 caratteri), non come campo del body — i retry riutilizzano lo stesso job.

Endpoint: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Autenticazione Bearer.
GET /v1/download/{token}/{file} — autenticato tramite token nell'URL, nessun header Bearer.

Prezzi

Paghi per le clip, non per le postazioni.

I crediti prepagati alimentano l'API di taglio di AppsGolem & il server MCP — ogni clip prodotta corrisponde a un credito, e i tagli falliti non vengono mai addebitati. Acquista un pacchetto per un uso occasionale, oppure abbonati per un volume mensile costante e un limite di richieste più alto.

№ 01 / Pacchetti prepagati

Paga a consumo.

Acquisto una tantum, senza rinnovo. I crediti restano validi per 12 mesi.

Pacchetto Starter

€5 una tantum

25 crediti · ≈ 25 clip standard

Valido 12 mesi

Inizia subito

Pacchetto PAYG Più conveniente

€25 una tantum

150 crediti · ≈ 150 clip standard

Valido 12 mesi · €0,17 / credito

Inizia subito

№ 02 / Abbonamenti

Taglia ogni mese.

I crediti si rinnovano a ogni periodo e il tuo limite di richieste aumenta. Annulla quando vuoi.

Starter

€19 / mese

oppure €190 / anno · 2 mesi gratis

250 crediti / mese

30 richieste / ora
I crediti si rinnovano mensilmente
Annulla quando vuoi

Inizia subito

★ Più popolare Pro

€49 / mese

oppure €490 / anno · 2 mesi gratis

1000 crediti / mese

60 richieste / ora
I crediti si rinnovano mensilmente
Annulla quando vuoi

Inizia subito

Scale

€149 / mese

oppure €1490 / anno · 2 mesi gratis

5000 crediti / mese

120 richieste / ora
I crediti si rinnovano mensilmente
Annulla quando vuoi

Inizia subito

Gli abbonamenti concedono in anticipo i crediti dell'intero periodo e aumentano il tuo limite di richieste/ora. I piani annuali fatturano 10 mesi su 12.

№ 03 / Come funzionano i crediti