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.
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
}
}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émarrageMédias
Importez images, vidéos, audio et polices une seule fois, puis référencez-les par ID.
Docs médiasModèles
Lisez les champs d'un modèle, puis générez une version figée avec de nouvelles valeurs.
Docs modèlesRendus
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 renduRendus en masse
Envoyez des lignes JSON ou CSV ; chaque ligne est vérifiée et suivie séparément.
Génération en masseWebhooks
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 APIn8n 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.
Créer ou sélectionner
Démarrez un projet image ou vidéo, ou sélectionnez un modèle versionné.
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.
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.