O acesso à API abre junto com o estúdio.
Tudo o que o estúdio faz, disponível para o seu produto: crie clipes, locuções, personagens falantes e animações com som, peça mudanças em linguagem natural, exporte arquivos e acompanhe o progresso ao vivo. A API abre junto com o estúdio; esta página descreve o que está por vir.
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 e caminho | Para que serve |
|---|---|
POST /v1/music-videos | Criar um clipe a partir de uma ideia, com letra e estilos opcionais |
POST /v1/animations | Criar um vídeo com locução, um personagem falante ou uma animação com som |
GET /v1/scenes/{id} | Ler um vídeo e a versão atual |
POST /v1/scenes/{id}/revisions | Pedir uma mudança em linguagem natural |
GET /v1/scenes/{id}/versions | A árvore de versões |
POST /v1/scenes/{id}/exports | Renderizar MP4, WebM ou GIF em 720p, 1080p ou 4K |
GET /v1/jobs/{id}/events | Progresso ao vivo como Server-Sent Events |
GET /v1/usage | Saldo de créditos e uso no período |
Envie sua chave como token bearer. Chaves de produção começam com mog_live_ e as de teste com mog_test_. As de teste são grátis e devolvem resultados de exemplo realistas, então nada é cobrado. Cada chave aparece uma única vez; guardamos só um hash.
Criar um vídeo devolve 202 com um trabalho. Consulte o trabalho, acompanhe o progresso como Server-Sent Events ou receba um webhook assinado quando terminar.
Todo POST aceita o cabeçalho Idempotency-Key. Repetir uma requisição em até 24 horas devolve a resposta original em vez de criar um segundo vídeo.
Os erros seguem o formato problem details da RFC 9457, com type e code estáveis, para o seu código decidir sem ler mensagens.
Toda resposta traz os cabeçalhos RateLimit e RateLimit-Policy. Acima do limite você recebe 429 com Retry-After. Trabalhos longos entram na fila em vez de falhar quando você atinge o limite de concorrência.
Eventos: job.succeeded, job.failed, revision.ready, export.ready e credits.low. São assinados com HMAC-SHA256 seguindo a especificação Standard Webhooks e reenviados por até 72 horas.