JsonCut

Production d'images et de vidéos.Connectée à votre produit.

Créez des projets, remplissez des modèles et générez des images ou des vidéos depuis votre propre code. Les requêtes répondent immédiatement, les rendus tournent en arrière-plan, et un webhook signé prévient votre app quand le fichier est prêt.

Une requête en entrée.Un événement signé en retour.

Soumettez un rendu avec une clé d'idempotence et obtenez son ID immédiatement. Une fois terminé, JsonCut envoie un événement signé à votre endpoint : aucune connexion n'a besoin de rester ouverte.

  • Même clé, même renduRépéter une requête avec la même clé d'idempotence renvoie le rendu existant.
  • Signé en HMAC SHA-256Vérifiez le corps brut, puis dédoublonnez par ID d'événement.
  • Relances et rejeuLes livraisons échouées sont relancées jusqu'à six fois ; ensuite, vous pouvez les rejouer.
Ouvrir la référence API et le playground
Soumettre un rendu · 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"
  }'
Événement webhook · 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
  }
}

Une petite API publique.Tout ce qu'il faut pour la production.

Six groupes d'opérations, chacun documenté avec paramètres, schémas et réponses dans la référence interactive.

  • Projets

    Créez et mettez à jour des projets image ou vidéo qui restent modifiables dans Studio.

    Les projets dans le guide de démarrage
  • Médias

    Importez images, vidéos, audio et polices une seule fois, puis référencez-les par ID.

    Docs médias
  • Modèles

    Lisez les champs d'un modèle, puis générez une version figée avec de nouvelles valeurs.

    Docs modèles
  • Rendus

    Mettez une image ou une vidéo en file d'attente, lisez son état, annulez-la ou téléchargez le fichier.

    Cycle de vie du rendu
  • Rendus en masse

    Envoyez des lignes JSON ou CSV ; chaque ligne est vérifiée et suivie séparément.

    Génération en masse
  • Webhooks

    Recevez des événements signés « terminé », « échoué » et « annulé », et rejouez une livraison.

    Docs webhooks

Un seul cycle de viepour chaque rendu.

Les rendus de projet, de modèle et en masse deviennent tous la même ressource de rendu, pour les images comme pour la vidéo. Votre code gère cinq états.

Lire le cycle de vie du rendu
queued
Acceptée, en attente d'un moteur de rendu
rendering
Images en cours de génération
completed
Le fichier et ses métadonnées sont prêts à être téléchargés
failed
Une raison lisible, et si une nouvelle tentative a du sens
cancelled
Arrêté sur demande avant la fin

S'intègre à la stackque vous utilisez déjà.

  • N'importe quel client HTTP

    Du JSON simple via HTTPS avec un en-tête X-API-Key, depuis n'importe quel langage.

  • OpenAPI 3.1

    Un fichier OpenAPI public pour générer un client typé ou tester des appels dans le playground.

    Référence API
  • n8n et Make

    Remplissez des modèles et lancez des rendus depuis un workflow no-code.

  • MCP pour les agents

    Laissez Claude, ChatGPT ou un autre client travailler dans les mêmes projets.

    JsonCut MCP

Du premier appelau fichier dans votre app.

  1. Créer ou sélectionner

    Démarrez un projet image ou vidéo, ou sélectionnez un modèle versionné.

  2. Joindre médias et données

    Utilisez des imports de médias multipart et des entrées typées au lieu d'intégrer de gros fichiers dans chaque requête.

  3. Générer et suivre

    Envoyez une tâche de sortie, interrogez son statut ou recevez un webhook, puis récupérez le résultat.

Avant d'intégrer.Questions sur l'API.

Le JSON reste-t-il le format du document créatif ?

Non. Vous concevez dans Studio ou avec l'AI Director ; le JSON est seulement la façon dont l'API envoie et reçoit les projets et les valeurs des modèles.

Puis-je générer un rendu sans enregistrer de projet ?

Un rendu inline existe pour les travaux ponctuels assumés, mais les workflows itératifs doivent passer par des projets.

Existe-t-il un SDK ?

Pas encore sous forme de package. L'API est du JSON simple sur HTTPS avec un fichier OpenAPI public : n'importe quel client HTTP fonctionne, ou vous en générez un typé. n8n et Make l'appellent sans code.

Créez une clé API dans Studio.Générez votre premier fichier aujourd'hui.