El acceso a la API abre junto con el estudio.
Todo lo que hace el estudio, disponible para tu producto: crea videos musicales, voces en off, personajes que hablan y animaciones con sonido, pide cambios en lenguaje natural, exporta archivos y sigue el progreso en vivo. La API abre junto con el estudio; esta página describe lo que viene.
curl https://api.mogable.com/v1/music-videos \
-H "Authorization: Bearer mog_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 4f6c1d2e-first-video" \
-d '{
"prompt": "a lo-fi song about the last train home",
"aspect_ratio": "9:16",
"webhook_url": "https://example.com/hooks/mogable"
}'| Método y ruta | Para qué sirve |
|---|---|
POST /v1/music-videos | Crear un video musical a partir de una idea, con letra y estilos opcionales |
POST /v1/animations | Crear un video con voz en off, un personaje que habla o una animación con sonido |
GET /v1/scenes/{id} | Leer un video y su versión actual |
POST /v1/scenes/{id}/revisions | Pedir un cambio en lenguaje natural |
GET /v1/scenes/{id}/versions | El árbol de versiones |
POST /v1/scenes/{id}/exports | Renderizar MP4, WebM o GIF en 720p, 1080p o 4K |
GET /v1/jobs/{id}/events | Progreso en vivo como Server-Sent Events |
GET /v1/usage | Saldo de créditos y consumo del periodo |
Envía tu clave como token bearer. Las claves de producción empiezan con mog_live_ y las de prueba con mog_test_. Las de prueba son gratis y devuelven resultados de ejemplo realistas, así que no se cobra nada. Mostramos cada clave una sola vez y solo guardamos un hash.
Crear un video devuelve 202 con un trabajo. Puedes consultarlo, seguir su progreso como Server-Sent Events o recibir un webhook firmado cuando termine.
Todo POST acepta el encabezado Idempotency-Key. Si repites una solicitud dentro de las 24 horas, recibes la respuesta original en vez de un segundo video.
Los errores siguen el formato problem details del RFC 9457, con un type y un code estables, para que tu código decida sin leer mensajes.
Cada respuesta incluye los encabezados RateLimit y RateLimit-Policy. Si te pasas, recibes 429 con Retry-After. Los trabajos largos esperan en la cola en vez de fallar cuando alcanzas tu límite de concurrencia.
Eventos: job.succeeded, job.failed, revision.ready, export.ready y credits.low. Van firmados con HMAC-SHA256 según la especificación Standard Webhooks y se reintentan durante 72 horas.