ClipReel für Agenten

Videobearbeitung mit KI-Agenten automatisieren

Verwende die ClipReel REST-API, um Produktdemos, Social-Media-Schnitte, Untertitel und überprüfbare Bearbeitungen mit dauerhaften Render-Jobs zu automatisieren.

Agent verbinden

Bearbeitung an echtem Material testen

Vergleiche die achtsekündige Quelldatei mit dem sechssekündigen Schnitt. Öffne das Beispielprojekt mit der vorbereiteten Anfrage.

Kürze die ersten zwei Sekunden, füge den Titel „A day on the ridge“ für drei Sekunden hinzu, mache das Color Grading kühler und blende in der letzten halben Sekunde aus.
In ClipReel testen Quellclip herunterladen
Originalaufnahme
Kürzen, Titel und Blende

Mit ClipReel verbinden

Erstellen Sie ein bereichsbeschränktes Token, speichern Sie es als CLIPREEL_API_TOKENund konfigurieren Sie Ihren Client. Verwenden Sie ein Projekt-Lese-, Projekt-Schreib- und Job-Token für die Anleitung.

curl https://www.clipreel.com/api/v1/projects \
  -H "Authorization: Bearer $CLIPREEL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Product walkthrough"}'

Produktdemo schrittweise automatisieren

Erstellen Sie ein Projekt für jeden Start und importieren Sie die ursprünglichen Bildschirmaufnahmen. Stellen Sie edit_by_prompt mit einem klaren Anfang, einer Zieldauer und Untertitelanforderungen in die Warteschlange. Übermitteln Sie einen Idempotenz-Schlüssel für jeden Auftrag, damit bei einem erneuten Versuch das ursprüngliche Ergebnis wiederhergestellt werden kann.

Erstellen Sie soziale Versionen aus dem genehmigten Schnitt

Fixieren Sie dieselbe gespeicherte Revision in jeder export_video-Anfrage und senden Sie einen eindeutigen Schlüssel für 16:9, 9:16 oder Quadrat. Fragen Sie die Job-Ressource nach dem nächsten Status ab. Verwenden Sie den Bearbeitungslink, um dasselbe Filmmaterial, Schnitte, Untertitel und Effekte zu öffnen, bevor Sie einen weiteren Export anfordern.

Behandeln Sie Fehler und Berechtigungen in Ihrer Integration

Verwenden Sie bereichsbezogene Konto-Token und laden Sie direkt auf die signierte URL hoch. Überprüfen Sie Callback-Signaturen anhand des rohen Anfragekörpers, bevor Sie einen Abschluss lesen. Verwenden Sie die stabile Job-ID für die Handhabung von Wiederholungsversuchen. Erstellen Sie für eine Partner-App eine bereichsbezogene Einbettungssitzung für deren genauen Ursprung und Projekt.

REST-Workflows

Senden Sie JSON mit Authorization: Bearer $CLIPREEL_API_TOKEN. Senden Sie für einen Dateiimport den deklarierten Dateinamen, den Medientyp, die Bytee-Länge und die Dauer an POST /tools/import_media. Laden Sie die Datei mit demselben Inhaltstyp und derselben Länge auf die zurückgegebene URL hoch.

Entwurf eines Launch-Cuts

POST https://www.clipreel.com/api/v1/tools/edit_by_prompt
{
  "projectId": "PROJECT_ID",
  "prompt": "Remove pauses, add captions, and cut a 45-second launch video",
  "idempotencyKey": "launch-v1-edit"
}

Untertitel-Cues generieren oder importieren

Warteschlange POST /tools/transcribe_video mit der Projekt-ID. Fragen Sie dann ab GET /jobs/JOB_ID. Übergeben Sie die zurückgegebenen result.cues to POST /tools/add_captions mit einem Stil wie white or lime. Verwenden Sie dasselbe Cue-Objekt für Zeitstempel, die Sie selbst bereitstellen.

Einen vertikalen Schnitt exportieren

POST https://www.clipreel.com/api/v1/tools/export_video
{
  "projectId": "PROJECT_ID", "revision": 7,
  "aspect": "9:16", "resolution": "720p",
  "idempotencyKey": "launch-v1-vertical", "webhookId": "WEBHOOK_ID"
}

Signierte Callbacks verifizieren

Registrieren Sie Ihren HTTPS-Endpunkt bei POST /webhooks mit {"url":"https://partner.example.com/clipreel"}. Speichern Sie das zurückgegebene Signierungsgeheimnis. Berechnen Sie HMAC-SHA256 über den Unix-Zeitstempel, einen Punkt und den rohen Anfragekörper. Vergleichen Sie in konstanter Zeit mit v1 im ClipReel-Signature Header. Lehnen Sie Zeitstempel ab, die älter als fünf Minuten sind. Behandeln Sie ClipReel-Delivery als Deduplizierungs-ID. Fragen Sie nach neuen signierten Medienlinks.

Dasselbe bearbeitbare Projekt einbetten

POST https://www.clipreel.com/api/v1/embed-sessions
{
  "projectId": "PROJECT_ID",
  "origin": "https://partner.example.com",
  "permission": "edit"
}

Laden Sie embedUrl in einem iFrame auf dem registrierten Ursprung. Sitzungen dauern 20 Minuten und erben die Berechtigungen des Tokens. Setzen Sie permission to view für eine Sitzung nur zur Überprüfung. Öffnen in ClipReel bringt den Editor zurück zum privaten Projekt im vollständigen Arbeitsbereich.

Client-Setup und Workflows

Videobearbeitung in Claude Code

Bitte Claude Code, Aufnahmen in einen bearbeitbaren Schnitt zu verwandeln. Überprüfe ein Preview und öffne dann dasselbe Projekt in ClipReel.

Claude Code einrichten
Die ersten zwei Sekunden kürzen.

MCP-Server für Videobearbeitung

Verbinde einen MCP-Client mit ClipReel, um Projekte zu erstellen, Timeline-Änderungen vorzuschlagen, Previews zu prüfen und bearbeitbare Schnitte zu exportieren.

MCP-Einrichtung

Produktvideos aus Cursor bearbeiten

Verwende Cursor und ClipReel, um Produkt-Walkthrough-Aufnahmen in ein bearbeitbares Video mit Untertiteln und mehreren Exportformaten zu verwandeln.

Cursor-Workflow

Videobearbeitung mit KI-Agenten automatisieren

Verwende die ClipReel REST-API, um Produktdemos, Social-Media-Schnitte, Untertitel und überprüfbare Bearbeitungen mit dauerhaften Render-Jobs zu automatisieren.

REST-API-Leitfaden

Gehostete Jobs nutzen deinen ClipReel-Plan. Chat-Bearbeitungen und Videoguthaben nach Plan ansehen.