JsonCut

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.
API-Referenz und Playground öffnen
Rendering absenden · cURL
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"
  }'
Webhook-Event · JSON
{
  "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 Quickstart
  • Medien

    Lade Bilder, Videos, Audio und Schriften einmal hoch oder importiere sie und referenziere sie dann per ID.

    Medien-Doku
  • Vorlagen

    Lies die Felder einer Vorlage aus und rendere dann eine feste Version mit neuen Werten.

    Vorlagen-Doku
  • Renderings

    Stell ein Bild oder Video in die Warteschlange, frag seinen Status ab, brich es ab oder lade die Datei herunter.

    Render-Lebenszyklus
  • Massen-Renderings

    Sende JSON- oder CSV-Zeilen; jede Zeile wird einzeln geprüft und verfolgt.

    Massengenerierung
  • Webhooks

    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-Referenz
  • n8n 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.

  1. Erstellen oder auswählen

    Starte ein Bild- oder Videoprojekt oder wähle eine versionierte Vorlage.

  2. Medien und Daten anhängen

    Nutze Multipart-Medien-Uploads und typisierte Eingaben, statt große Dateien in jeden Request einzubetten.

  3. 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.

Erstell einen API-Schlüssel im Studio.Rendere heute die erste Datei.