Bild- und Videoproduktion.Verbunden mit deinem Produkt.
Erstelle Projekte, befülle Vorlagen und rendere Bilder oder Videos aus deinem eigenen Code. Requests antworten sofort, Renderings laufen im Hintergrund, und ein signierter Webhook sagt deiner App, wann die Datei fertig ist.
Ein Request rein.Ein signiertes Event zurück.
Sende ein Rendering mit einem Idempotency-Key ab und erhalte sofort seine ID. Wenn es fertig ist, schickt JsonCut ein signiertes Event an deinen Endpunkt, sodass keine Verbindung offen bleiben muss.
- Gleicher Key, gleiches RenderingWiederholst du einen Request mit demselben Idempotency-Key, bekommst du das bestehende Rendering zurück.
- Signiert mit HMAC SHA-256Prüf den rohen Request-Body und dedupliziere dann nach Event-ID.
- Wiederholungen und erneutes SendenFehlgeschlagene Zustellungen werden bis zu sechsmal wiederholt; danach kannst du sie erneut senden.
curl -X POST "$JSONCUT_API/api/v2/projects/$PROJECT_ID/renders" \
-H "X-API-Key: $JSONCUT_API_KEY" \
-H "Idempotency-Key: product-launch-42" \
-H "Content-Type: application/json" \
-d '{
"kind": "video",
"format": "mp4"
}'{
"id": "render-27a1…:1:completed",
"type": "render.completed",
"createdAt": "2026-08-30T12:24:18Z",
"data": {
"renderId": "render-27a1…",
"status": "completed",
"phase": "finalizing",
"progress": 100,
"artifactCount": 1
}
}Eine kleine öffentliche API.Alles, was Produktion braucht.
Sechs Gruppen von Operationen, jede in der interaktiven Referenz mit Parametern, Schemas und Antworten dokumentiert.
Projekte
Erstelle und aktualisiere Bild- oder Videoprojekte, die im Studio bearbeitbar bleiben.
Projekte im QuickstartMedien
Lade Bilder, Videos, Audio und Schriften einmal hoch oder importiere sie und referenziere sie dann per ID.
Medien-DokuVorlagen
Lies die Felder einer Vorlage aus und rendere dann eine feste Version mit neuen Werten.
Vorlagen-DokuRenderings
Stell ein Bild oder Video in die Warteschlange, frag seinen Status ab, brich es ab oder lade die Datei herunter.
Render-LebenszyklusMassen-Renderings
Sende JSON- oder CSV-Zeilen; jede Zeile wird einzeln geprüft und verfolgt.
MassengenerierungWebhooks
Empfange signierte Events für abgeschlossen, fehlgeschlagen und abgebrochen und sende eine Zustellung erneut.
Webhook-Doku
Ein Lebenszyklusfür jedes Rendering.
Projekt-, Template- und Massen-Renderings werden alle zur selben Render-Ressource, für Bilder wie für Video. Dein Code verzweigt nach fünf Zuständen.
Render-Lebenszyklus lesen- queued
- Angenommen, wartet auf einen Renderer
- rendering
- Frames werden erzeugt
- completed
- Die Datei und ihre Metadaten stehen zum Download bereit
- failed
- Ein verständlicher Grund und ob ein erneuter Versuch sinnvoll ist
- cancelled
- Auf Anfrage gestoppt, bevor es fertig war
Passt in den Stack,den du schon nutzt.
Jeder HTTP-Client
Einfaches JSON über HTTPS mit einem X-API-Key-Header, aus jeder Sprache.
OpenAPI 3.1
Eine öffentliche OpenAPI-Datei, um einen typisierten Client zu generieren oder Aufrufe im Playground zu testen.
API-Referenzn8n und Make
Befülle Vorlagen und starte Renderings aus einem No-Code-Workflow.
MCP für Agenten
Lass Claude, ChatGPT oder einen anderen Client in denselben Projekten arbeiten.
JsonCut MCP
Vom ersten Aufrufbis zur Datei in deiner App.
Erstellen oder auswählen
Starte ein Bild- oder Videoprojekt oder wähle eine versionierte Vorlage.
Medien und Daten anhängen
Nutze Multipart-Medien-Uploads und typisierte Eingaben, statt große Dateien in jeden Request einzubetten.
Rendern und beobachten
Reiche einen Ausgabe-Job ein, frag den Status ab oder empfange einen Webhook und hol dir dann das Ergebnis.
Bevor du integrierst.Fragen zur API.
Ist JSON noch das kreative Dokumentformat?
Nein. Du gestaltest im Studio oder mit dem AI Director; JSON ist nur das Format, in dem die API Projekte und Vorlagenwerte sendet und empfängt.
Kann ich rendern, ohne ein Projekt zu speichern?
Für bewusste One-Shot-Arbeiten gibt es einen Inline-Render-Weg; iterative Workflows sollten Projekte nutzen.
Gibt es ein SDK?
Noch nicht als Paket. Die API ist einfaches JSON über HTTPS mit einer öffentlichen OpenAPI-Datei – jeder HTTP-Client funktioniert, oder du generierst dir einen typisierten. n8n und Make rufen sie ohne Code auf.