API développeur · serveur MCP

Découpez des clips YouTube depuis votre code.

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

Une API REST simple et un serveur MCP pour les agents AI — tout ce que fait l'outil de découpe web, de façon programmatique. Crédits prépayés, sans abonnement.

Obtenir une clé API Démarrage rapide

API + MCP pour agents de codage →

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

Comment ça marche

Nouveau ici ? Tout le fonctionnement en une minute.

Vous achetez des crédits prépayés, créez une clé API, et appelez un seul endpoint pour découper un clip. Le découpage est asynchrone : vous soumettez un job, vous interrogez le statut jusqu'à ce qu'il soit produit, puis vous téléchargez le fichier depuis une URL tokenisée. Le serveur MCP regroupe tout cela en un seul appel d'outil pour les agents IA. Pas d'abonnement, pas de sièges — vous payez par clip produit.

1 · S'authentifier

Envoyez votre clé sous la forme Authorization: Bearer ag_live_… à chaque requête.

2 · Envoyer et interroger

POST /v1/cuts renvoie un id de job ; interrogez GET /v1/cuts/{id} jusqu'à ce qu'il soit produit.

3 · Télécharger

Récupérez le download_url depuis le job produit — aucun en-tête requis, le token l'autorise.

Démarrage rapide

De zéro à un clip en quatre appels.

01

Créer une clé 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

Soumettre une découpe

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

Interroger l'URL de téléchargement

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

Les états passent par accepted → queued → produced → delivered (ou failed → refunded). Un clip court est généralement prêt en quelques secondes ; interrogez toutes les 3–5 s.

Les liens de téléchargement expirent 72 heures après la génération de l'extrait — téléchargez-le dans ce délai.

04

Télécharger le clip

L'URL avec jeton diffuse le MP4 — réutilisable jusqu'à son expiration. L'outil MCP cut_youtube_video effectue les étapes 2–4 pour vous en un seul appel.

Pour les agents AI · MCP

Une ligne pour Claude, Cursor et Codex.

Le serveur MCP expose l'outil de découpe sous forme de trois outils que tout client MCP peut appeler. Installez avec npx — rien à installer globalement.

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

Soumettez une découpe (n'importe quel mode, des options, ou un tableau clips) et récupérez une URL de téléchargement en retour.

get_cut_status()

Vérifiez une tâche par son id et récupérez son URL de téléchargement.

get_account_balance()

Vos crédits disponibles et votre plafond horaire.

Ce qu'il faut dire à votre agent — toutes les fonctionnalités

“Découper de 0:30 à 1:15 d'une vidéo en 1080p”

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

“Récupérer l'audio de cette vidéo de 2:00–5:00 en MP3 320 kbps”

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

“Exporter la vidéo et un MP3 des 30 premières secondes”

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

“Créer un short vertical 9:16 du moment fort 10:00–10:45”

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

“Transformer 0:05–0:12 en GIF”

cut_youtube_video(…, mode="gif")

“Extraire un contact sheet d'images toutes les 5 secondes de 1:00–2:00”

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

“Stitch 0:10–0:20 et 1:00–1:10 en un seul clip”

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

“Effectuer une découpe fast, en stream-copy, des 30 premières secondes”

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

“Découper 0:00–0:20 à une vitesse de 1.5×, en 4K”

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

“Combien de crédits API me reste-t-il ?”

get_account_balance()

“Vérifier le job e48d…b1a2”

get_cut_status(job_id="e48d…b1a2")

L'agent remplit les paramètres à partir de votre demande — vous n'écrivez pas de JSON.

Référence API

Chaque endpoint, avec des exemples.

Quatre endpoints. Les trois endpoints de lecture/écriture prennent Authorization: Bearer <key> ; l'URL de téléchargement est autorisée par son propre token, elle n'a donc besoin d'aucun en-tête.

POST /v1/cuts Bearer

Requête · video

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

Réponse · 202 Accepted

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

Indiquez soit start+end, soit un tableau clips (1–10 fenêtres). Ajoutez un en-tête Idempotency-Key (≤200 caractères) pour qu'une requête réessayée réutilise le même job au lieu de facturer deux fois.

Corps de la requête par 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 par IA

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

nosoundMP4, sans audio

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

gif≤ 5 min, un seul clip

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

framesImages fixes JPG · ≤ 1800

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

clips + stitch1–10 → un seul fichier

{ "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éponse · 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 est l'un des suivants : accepted · queued · produced · delivered · failed · refunded. download_url apparaît une fois qu'un token est prêt — s'il est absent, interrogez à nouveau.

GET /v1/account Bearer

Réponse · 200

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

GET /v1/download/{token}/{file} Token dans l'URL

Réponse · 200

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

Pas d'en-tête Bearer — le token dans le chemin l'autorise. L'URL est réutilisable jusqu'à son expiration.

Erreurs

Chaque échec renvoie un corps JSON avec un code error et le statut HTTP. Réessayez après un 429 une fois retry_after secondes écoulées ; corrigez et soumettez à nouveau en cas de 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 de débit: Seules les soumissions de découpe sont limitées en fréquence — le nombre de soumissions/heure de votre forfait (voir Tarifs). Consulter la progression d'une tâche n'est pas limité en usage normal, donc l'interrogation ne compte jamais dans ce quota. Respectez poll_after dans chaque réponse (et Retry-After lors du rare 429) ; l'outil MCP gère ce rythme pour vous avec wait=true.

Fonctionnalités

Tous les modes de l'outil de découpe web.

MODE video

MP4 jusqu'en 4K

144p–2160p, 60fps, sans filigrane.

MODE audio_only

Audio

mp3 / m4a / wav / flac, débit binaire sélectionnable.

MODE both

Vidéo + audio

MP4 et MP3 ensemble, dans un zip.

MODE nosound

Vidéo sans son

Vidéo sans piste audio.

MODE short

9:16 vertical

Recadrage intelligent AI pour Shorts, Reels et TikTok; bascule sur des bandes noires floutées si indisponible.

MODE gif

GIF animé

Jusqu'à 5 minutes, directement à partir d'un clip.

MODE frames

Images JPG

Toutes les 100ms–10s, horodatages + planche contact.

OPTION fast

Mode rapide

Copie de flux (stream-copy), environ 10× plus rapide ; conserve le conteneur source (WebM en 1440p/2160p).

OPTION speed

Vitesse 0.5–2×

Réajuste la lecture au moment de l'export.

OPTION clips

Assemblage multi-clips

Jusqu'à 10 segments réunis en un seul fichier.

Référence

Paramètres

Champ

Type

Remarques

url

string

URL YouTube watch / share / youtu.be.

start, end

string

"SS" / "MM:SS" / "HH:MM:SS" (≤ 300h). À omettre si vous utilisez clips.

resolution

enum

144p · 240p · 360p · 480p · 720p · 1080p · 1440p · 2160p (4K; durée totale de la découpe ≤ 60 min).

mode

enum

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

audio_format

enum

mp3 · m4a · wav · flac — uniquement pour audio_only; both est toujours en MP3.

bitrate

enum

Débit avec perte 320 · 256 · 192 · 128 kbps — MP3/M4A (audio_only), MP3 (both); ignoré pour wav/flac.

fast

boolean

Stream-copy, environ 10× plus rapide — video, nosound, both uniquement; force speed à 1×.

speed

number

Vitesse de lecture 0.5 · 1 · 1.25 · 1.5 · 2 — video, nosound, both, audio_only.

interval_ms

integer

Échantillonnage des images : 100 · 500 · 1000 · 2000 · 5000 · 10000 ms; ≤ 1800 JPG au total.

burn_ts

boolean

Images — incruste l'horodatage source sur chaque JPG.

sheet

boolean

Images — un unique JPG planche-contact (un seul clip); désactive burn_ts.

clips

array

1–10 segments {start,end}; réglez stitch pour les assembler en un seul fichier.

stitch

boolean

Avec clips, assemblez-les en un seul fichier — video, audio_only, both, short, nosound.

Idempotency-Key

header

Envoyé en en-tête HTTP (≤ 200 caractères), pas en champ du corps — les nouvelles tentatives réutilisent la même tâche.

Points de terminaison: POST /v1/cuts · GET /v1/cuts/{id} · GET /v1/account — Authentification Bearer.
GET /v1/download/{token}/{file} — authentifié par le token d'URL, sans en-tête Bearer.

Tarifs

Payez pour les clips, pas pour des licences.

Les crédits prépayés alimentent l'API de découpe AppsGolem & le serveur MCP — chaque clip produit consomme un crédit, et les découpes échouées ne sont jamais facturées. Achetez un pack pour un usage occasionnel, ou abonnez-vous pour un volume mensuel régulier et une limite de requêtes plus élevée.

№ 01 / Packs prépayés

Payez à l'usage.

Achat unique, sans renouvellement. Les crédits restent valables 12 mois.

Pack Starter

€5 paiement unique

25 crédits · ≈ 25 clips standard

Valable 12 mois

Commencer

Pack PAYG Meilleure offre

€25 paiement unique

150 crédits · ≈ 150 clips standard

Valable 12 mois · €0,17 / crédit

Commencer

№ 02 / Abonnements

Découpez chaque mois.

Les crédits se renouvellent à chaque période et votre limite de requêtes augmente. Annulez à tout moment.

Starter

€19 / mois

ou €190 / an · 2 mois offerts

250 crédits / mois

30 requêtes / heure
Les crédits se renouvellent chaque mois
Annulez à tout moment

Commencer

★ Le plus populaire Pro

€49 / mois

ou €490 / an · 2 mois offerts

1000 crédits / mois

60 requêtes / heure
Les crédits se renouvellent chaque mois
Annulez à tout moment

Commencer

Scale

€149 / mois

ou €1490 / an · 2 mois offerts

5000 crédits / mois

120 requêtes / heure
Les crédits se renouvellent chaque mois
Annulez à tout moment

Commencer

Les abonnements accordent d'avance les crédits de toute la période et augmentent votre limite de requêtes/heure. Les forfaits annuels facturent 10 mois pour 12.

№ 03 / Comment fonctionnent les crédits