Producción de imagen y vídeo.Conectada a tu producto.
Crea proyectos, rellena plantillas y renderiza imágenes o vídeo desde tu propio código. Las solicitudes responden al instante, los renderizados se ejecutan en segundo plano y un webhook firmado avisa a tu app cuando el archivo está listo.
Entra una solicitud.Vuelve un evento firmado.
Envía un renderizado con una clave de idempotencia y obtén su ID al momento. Cuando termina, JsonCut envía un evento firmado a tu endpoint, así que nada tiene que mantener una conexión abierta.
- Misma clave, mismo renderizadoRepetir una solicitud con la misma clave de idempotencia devuelve el renderizado existente.
- Firmado con HMAC SHA-256Verifica el cuerpo sin procesar y luego elimina duplicados por ID de evento.
- Reintentos y reenvíoLas entregas fallidas se reintentan hasta seis veces; después puedes reenviarlas.
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
}
}Una API pública pequeña.Todo lo que necesita la producción.
Seis grupos de operaciones, cada uno documentado con parámetros, esquemas y respuestas en la referencia interactiva.
Proyectos
Crea y actualiza proyectos de imagen o vídeo que siguen siendo editables en Studio.
Proyectos en la guía rápidaMedios
Sube o importa imágenes, vídeo, audio y fuentes una vez y luego referéncialos por ID.
Documentación de mediosPlantillas
Lee los campos de una plantilla y renderiza una versión fija con nuevos valores.
Documentación de plantillasRenderizados
Pon en cola una imagen o un vídeo, consulta su estado, cancélalo o descarga el archivo.
Ciclo de vida del renderizadoRenderizados masivos
Envía filas JSON o CSV; cada fila se comprueba y se sigue por separado.
Generación masivaWebhooks
Recibe eventos firmados de completado, fallido y cancelado, y reenvía una entrega.
Documentación de webhooks
Un solo ciclo de vidapara cada renderizado.
Los renderizados de proyectos, plantillas y masivos se convierten en el mismo recurso de renderizado, tanto para imágenes como para vídeo. Tu código solo distingue cinco estados.
Leer el ciclo de vida del renderizado- queued
- Aceptado, esperando un renderizador
- rendering
- Se están generando los fotogramas
- completed
- El archivo y sus metadatos están listos para descargar
- failed
- Un motivo legible y si tiene sentido reintentarlo
- cancelled
- Detenido a petición antes de terminar
Encaja en el stackque ya usas.
Cualquier cliente HTTP
JSON simple sobre HTTPS con una cabecera X-API-Key, desde cualquier lenguaje.
OpenAPI 3.1
Un archivo OpenAPI público para generar un cliente tipado o probar llamadas en el playground.
Referencia de la APIn8n y Make
Rellena plantillas e inicia renderizados desde un flujo sin código.
MCP para agentes
Deja que Claude, ChatGPT u otro cliente trabajen en los mismos proyectos.
JsonCut MCP
Desde la primera llamadahasta un archivo en tu app.
Crea o selecciona
Empieza un proyecto de imagen o vídeo, o selecciona una plantilla versionada.
Adjunta medios y datos
Usa subidas de medios multipart y entradas tipadas en lugar de incrustar archivos grandes en cada solicitud.
Renderiza y supervisa
Envía un trabajo de salida, consulta el estado o recibe un webhook y obtén el resultado.
Antes de integrar.Preguntas sobre la API.
¿JSON sigue siendo el formato del documento creativo?
No. Diseñas en Studio o con el AI Director; JSON es solo la forma en que la API envía y recibe proyectos y valores de plantilla.
¿Puedo renderizar sin guardar un proyecto?
Existe una vía de renderizado inline para trabajos puntuales deliberados, pero los flujos iterativos deben usar proyectos.
¿Hay un SDK?
Todavía no como paquete. La API es JSON plano sobre HTTPS con un archivo OpenAPI público, así que sirve cualquier cliente HTTP o puedes generar uno tipado. n8n y Make la llaman sin código.