Video a mano es trabajo.Video en la API es parte de tu producto.
Subir uno por uno, esperar a que procese, copiar el embed, mirar la pantalla para saber cuándo quedó listo. Cada video se vuelve una tarea manual. Con la API de Moviie tu backend reserva el upload, manda generar subtítulos, cortes y ebook, toma el embed y recibe un webhook firmado en el instante en que el video está listo. El pipeline corre sin que nadie abra el panel. REST versionada en api.moviie.ai/v1, una clave privada, OpenAPI publicada, webhook firmado. Todo documentado, con un ejemplo que corre.
El video que no es tu coreconsume el tiempo que debería ir al producto.
Bezos lo llamó muck: el trabajo pesado que no diferencia tu negocio. Su estimación en 2006 era que el 70% del esfuerzo de construir un producto era trabajo indiferenciado. Doce años después IDC lo puso en 80%. Operar video a mano es exactamente ese trabajo. A menos que el video sea tu producto, cada hora gastada empujando archivos por el panel es una hora que no fue a lo que te diferencia.
Sin API, todo video es un archivo arrastrado a la pantalla, una barra de progreso que vigilar, un embed que copiar y pegar en el lugar correcto. Multiplícalo por un catálogo que crece cada semana y el video se vuelve una fila de trabajo manual que nunca termina.
Cómo lo resuelve MoviieSin webhook, descubres el estado del video preguntando. Terminas haciendo polling, armando una fila improvisada, recargando la pantalla para ver si ya procesó. Y cuando el aviso por fin llega, llega sin firma, sin manera de confiar de dónde vino.
Cómo lo resuelve MoviieGenerar cortes, ebook, subtítulos y doblaje a clic, video por video, no escala junto con el catálogo. Lo que debería ser un paso de tu pipeline se vuelve una pantalla más que alguien tiene que abrir, en el tiempo de alguien, cada vez.
Cómo lo resuelve MoviieEl video entra en tu código.Y deja de ser tarea.
En Moviie el ciclo entero del video es API. Tu backend sube, manda generar, toma el embed y recibe aviso. REST versionada para dirigir la biblioteca, llamadas de IA para los materiales, y webhook firmado para reaccionar en el momento justo. El panel sigue existiendo, pero nada del pipeline depende de él.
Sube, lista, actualiza, organiza, todo en /v1.
La REST API versionada en api.moviie.ai/v1 dirige la biblioteca desde tu backend. Reserva un upload, lista y busca por reference_id (tu propio id ligado al video), actualiza, borra, organiza en colecciones y trae analytics de audiencia. Autentica con clave privada Bearer, y la OpenAPI publicada genera el client en tu lenguaje sin adivinar el contrato.
- Base versionada /v1, sin ruptura sin aviso
- Videos, Collections, Analytics y Me
- reference_id para ligarlo a tu base de datos
- OpenAPI publicada para generar el client
Cortes, ebook, quiz, doblaje, cada uno en una llamada.
Los materiales de IA del video no quedan atrapados en el panel: cada uno es un endpoint. Mandas generar cortes verticales, ebook, quiz y doblaje con voz clonada, y cada llamada vuelve al instante con un job que consultas. La generación corre en segundo plano y debita crédito, con reembolso íntegro si el job falla.
- Cortes, ebook, quiz y doblaje por API
- Corre async, con un job para consultar
- Debita crédito, con reembolso si falla
- Idempotente: un pedido igual en curso no se cobra de nuevo
El webhook te llama, tú no andas preguntando.
En el instante en que el video está listo, un subtítulo termina o el ancho de banda cruza un límite, el webhook llega a tu endpoint. Catálogo granular que enciendes por endpoint, firma HMAC-SHA256 en cada entrega, contador de intento en el header y reintento automático de hasta seis veces con backoff. Una falla solo se vuelve evento después de que un job la confirma, sin falsas alarmas.
- Catálogo granular, encendido por endpoint
- Firma HMAC-SHA256 en cada entrega
- Hasta 6 intentos, con backoff y X-Moviie-Attempt
- Falla confirmada por un job, sin falsa alarma
Operar video a manoy operarlo por la API.
El video final es el mismo. Lo que cambia es quién hace el trabajo: tú en el panel, o tu backend solo.
| Video a mano | Moviie API | |
|---|---|---|
| Subir el video | arrastrar a la pantalla, uno por uno | POST /uploads/reserve |
| Saber que quedó listo | recargar y mirar | webhook video.ready |
| Tomar el embed | copiar y pegar a mano | GET /videos/{id}/embed |
| Generar cortes, ebook, doblaje | clic, video por video | una llamada por material |
| Confiar en el aviso | sin manera de confiar | firma HMAC en cada entrega |
| Ligarlo a tu base de datos | una planilla aparte | reference_id en el propio video |
Los dos ponen el mismo video al aire. En uno, el trabajo es tuyo. En el otro, es de tu backend.
Una API.La plataforma entera por detrás.
Claves con alcance
Privada en el servidor para dirigir la biblioteca, publishable en el cliente para reproducir. Cada parte con el mínimo que necesita, sin exponer la clave que manda.
Video privado por token
Marca el video como privado y no sirve nada sin un JWT corto que tu backend firma. La protección vive en la misma plataforma de la API. Detalle completo en la página developers.
Player API por eventos
Cuando el tema sea controlar el reproductor en el navegador, esa es la Player API por eventos. Vive en la página developers, fuera del alcance de esta.
El panel refleja la API
Todo lo que la API hace, el panel lo muestra: clave, webhooks y signing secret salen de ahí. Código y panel andan juntos, no uno contra el otro.
¿Pasaste el límite? 429 con Retry-After
Los endpoints con rate limit responden 429 con Retry-After, y la generación sin saldo responde 402 con cuánto falta. Error previsible, documentado, fácil de manejar.
Todo liberado en tu plan
API y webhooks vienen en todo plan, junto con el resto. Los planes cambian la cuota de banda, storage y crédito, no la lista de recursos.
Lo que se puede automatizary cómo se comporta.
No. La REST API y la generación de IA usan una clave privada (prefijo mvi_), creada en el panel en Settings → API Keys, y toda llamada tiene que salir de tu backend. Para el cliente existe la clave publishable, con alcance solo de reproducción. La que dirige la biblioteca nunca aparece en el navegador.
Sí. Cada material de IA es un endpoint: reels, ebook, quiz y lipsync. La llamada vuelve al instante con un job, la generación corre en segundo plano y debita crédito, con reembolso íntegro si el job falla. Un pedido igual ya en curso se reaprovecha, no se cobra de nuevo.
Cada entrega llega firmada con HMAC-SHA256 en el header X-Moviie-Signature, calculada sobre el cuerpo crudo. Verificas la firma antes de leer el cuerpo, con el signing secret que sale del panel. Si una entrega falla, Moviie reintenta: hasta seis veces, con backoff cuadrático, y el número de intento viene en X-Moviie-Attempt.
La API tiene OpenAPI publicada, así que generas el client en tu lenguaje a partir del contrato, sin adivinar el payload y sin depender de un SDK que se atrasa. El contrato entero está en docs.moviie.ai, con un ejemplo que corre en cada endpoint.
El camino es subir el archivo: reservas el slot con POST /v1/videos/uploads/reserve y mandas el archivo al endpoint de upload firmado que devuelve. A partir de ahí el video es tuyo en Moviie, con embed, IA y webhook. La API dirige el ciclo del video que está en la plataforma.
Saca el video de la pantalla.Ponlo en tu backend.
14 días de prueba para reservar un upload, mandar generar los materiales y recibir el webhook firmado en tu endpoint. OpenAPI y ejemplos listos, el contrato entero en docs.moviie.ai. Sin llamada de ventas.