Recursos / API & Webhooks · EXPANDIR

Vídeo na mão é trabalho.Vídeo na API é parte do seu produto.

Subir um por um, esperar processar, copiar o embed, ficar olhando a tela pra saber quando ficou pronto. Cada vídeo vira tarefa manual. Com a API da Moviie o seu backend reserva o upload, manda gerar legenda, corte e ebook, pega o embed e recebe um webhook assinado no instante em que o vídeo fica pronto. O pipeline roda sem ninguém abrir o painel. REST versionada em api.moviie.ai/v1, chave privada, OpenAPI publicada, webhook assinado. Tudo documentado, com exemplo que roda.

Testar 14 dias grátis

REST /v1 versionada, com OpenAPI publicada Geração de IA por API: cortes, ebook, quiz, dublagem Webhook assinado, com retry e contador de tentativa

upload.shsh

# Upload a video, then start the AI reels job
curl -X POST https://api.moviie.ai/v1/videos \
  -H "Authorization: Bearer mvi_live_..." \
  -F "file=@lecture.mp4"

curl -X POST https://api.moviie.ai/v1/videos/vid_8a2f/reels \
  -H "Authorization: Bearer mvi_live_..."

embed.tsts

// Pull the player embed once the video is ready
const r = await fetch(
  'https://api.moviie.ai/v1/videos/vid_8a2f/embed',
  { headers: { Authorization: 'Bearer ' + process.env.MOVIIE_KEY } }
)
const { html } = await r.json()

video.readyjson

{
  "event": "video.ready",
  "data": {
    "id": "vid_8a2f",
    "embed": "https://watch.moviie.ai/embed/vid_8a2f"
  }
}

Quatro chamadas e um webhook: o request real, a resposta real, e o aviso assinado no instante em que o vídeo fica pronto.

O custo de operar vídeo na mão

Vídeo que não é o seu coreconsome o tempo que devia ir pro produto.

Bezos chamou isso de muck: o trabalho pesado que não diferencia o seu negócio. A estimativa dele em 2006 era que 70% do esforço de construir um produto era trabalho indiferenciado. Doze anos depois a IDC pôs em 80%. Operar vídeo na mão é exatamente esse trabalho. A menos que vídeo seja o seu produto, cada hora gasta empurrando arquivo pelo painel é uma hora que não foi pro que diferencia você.

Subir e esperar, um por um

Sem API, todo vídeo é um arquivo arrastado na tela, uma barra de progresso pra vigiar, um embed pra copiar e colar no lugar certo. Multiplique por um catálogo que cresce toda semana e o vídeo vira uma fila de trabalho manual que nunca termina.

Como a Moviie resolve

Perguntar quando ficou pronto

Sem webhook, você descobre o estado do vídeo perguntando. Fica fazendo polling, montando fila de gambiarra, recarregando a tela pra ver se já processou. E quando o aviso enfim chega, chega sem assinatura, sem como confiar de onde veio.

Como a Moviie resolve

Material de IA preso no painel

Gerar corte, ebook, legenda e dublagem clicando, vídeo a vídeo, não escala junto com o catálogo. O que devia ser um passo do seu pipeline vira mais uma tela que alguém precisa abrir, no tempo de alguém, toda vez.

Como a Moviie resolve

Três formas de gastar o seu dia.Todas porque o vídeo está fora do código, não dentro dele.

Como a Moviie resolve

O vídeo entra no seu código.E para de ser tarefa.

Na Moviie o ciclo inteiro do vídeo é API. Seu backend sobe, manda gerar, pega o embed e é avisado. REST versionada pra dirigir a biblioteca, chamadas de IA pros materiais, e webhook assinado pra reagir no instante certo. O painel continua existindo, mas nada do pipeline depende dele.

A biblioteca na REST

Sobe, lista, atualiza, organiza, tudo no /v1.

A REST API versionada em api.moviie.ai/v1 dirige a biblioteca do seu backend. Reserva upload, lista e busca por reference_id (o seu próprio id ligado ao vídeo), atualiza, apaga, organiza em coleções e puxa analytics de audiência. Autentica com chave privada Bearer, e a OpenAPI publicada gera o client na sua linguagem sem adivinhar contrato.

Base versionada /v1, sem quebra sem aviso
Videos, Collections, Analytics e Me
reference_id pra ligar ao seu banco
OpenAPI publicada pra gerar o client

A IA por chamada

Corte, ebook, quiz, dublagem, cada um numa chamada.

Os materiais de IA do vídeo não ficam presos no painel: cada um é um endpoint. Você manda gerar cortes verticais, ebook, quiz e dublagem com voz clonada, cada chamada volta na hora com um job que você consulta. A geração roda em background e debita crédito, com estorno integral se o job falhar.

Cortes, ebook, quiz e dublagem por API
Roda async, com job pra consultar
Debita crédito, com estorno se falhar
Idempotente: pedido igual em andamento não cobra de novo

O aviso assinado

O webhook te chama, você não fica perguntando.

No instante em que o vídeo fica pronto, uma legenda termina ou a banda cruza um limite, o webhook chega no seu endpoint. Catálogo granular que você liga por endpoint, assinatura HMAC-SHA256 em cada entrega, contador de tentativa no header e retry automático de até seis vezes com backoff. Falha só vira evento depois de um job confirmar, sem alarme falso.

Catálogo granular, ligado por endpoint
Assinatura HMAC-SHA256 em cada entrega
Até 6 tentativas, com backoff e X-Moviie-Attempt
Falha confirmada por job, sem alarme falso

Lado a lado

Operar vídeo na mãoe operar pela API.

O vídeo final é o mesmo. O que muda é quem faz o trabalho: você no painel, ou o seu backend sozinho.

	Vídeo na mão	Moviie API
Subir o vídeo	arrastar na tela, um por um	POST /uploads/reserve
Saber que ficou pronto	recarregar e olhar	webhook video.ready
Pegar o embed	copiar e colar à mão	GET /videos/{id}/embed
Gerar corte, ebook, dublagem	clicar, vídeo a vídeo	uma chamada por material
Confiar no aviso	sem como confiar	assinatura HMAC em cada entrega
Ligar ao seu banco	planilha à parte	reference_id no próprio vídeo

Os dois entregam o mesmo vídeo no ar. Num, o trabalho é seu. No outro, é do seu backend.

Vem junto

Uma API.A plataforma inteira atrás dela.

Chaves com escopo

Privada no servidor pra dirigir a biblioteca, publishable no cliente pra tocar. Cada parte com o mínimo que precisa, sem expor a chave que manda.

Vídeo privado por token

Marque o vídeo como privado e ele não serve nada sem um JWT curto que o seu backend assina. A proteção mora na mesma plataforma da API. Detalhe completo na página developers.

Player API por eventos

Quando o assunto for controlar o player no navegador, é a Player API por eventos. Mora na página developers, fora do escopo desta.

Painel espelha a API

Tudo que a API faz, o painel mostra: chave, webhooks e signing secret saem dali. Código e painel andam juntos, não um contra o outro.

Errou o limite? 429 com Retry-After

Endpoints com rate limit respondem 429 com Retry-After, e geração sem saldo responde 402 com o quanto falta. Erro previsível, documentado, fácil de tratar.

Tudo liberado no seu plano

API e webhooks vêm em todo plano, junto com o resto. Os planos mudam a cota de banda, storage e crédito, não a lista de recursos.

Sobre a API e os webhooks

O que dá pra automatizare como ela se comporta.

Qual chave a API usa, e ela pode ir pro frontend?

Não. A REST API e a geração de IA usam uma chave privada (prefixo mvi_), criada no painel em Settings → API Keys, e toda chamada tem que sair do seu backend. Pro cliente existe a chave publishable, com escopo só de tocar. Quem dirige a biblioteca nunca aparece no navegador.

Dá pra gerar corte, ebook e dublagem por API, sem abrir o painel?

Dá. Cada material de IA é um endpoint: reels, ebook, quiz e lipsync. A chamada volta na hora com um job, a geração roda em background e debita crédito, com estorno integral se o job falhar. Um pedido igual já em andamento é reaproveitado, não cobrado de novo.

Como sei que o webhook veio mesmo da Moviie?

Cada entrega chega assinada com HMAC-SHA256 no header X-Moviie-Signature, calculada sobre o corpo cru. Você confere a assinatura antes de ler o corpo, com o signing secret que sai do painel. Se a entrega falhar, a Moviie tenta de novo: até seis vezes, com backoff quadrático, e o número da tentativa vem em X-Moviie-Attempt.

Tem SDK ou client oficial?

A API tem OpenAPI publicada, então você gera o client na sua linguagem a partir do contrato, sem adivinhar payload e sem depender de um SDK que atrasa. O contrato inteiro está em docs.moviie.ai, com exemplo que roda em cada endpoint.

Importa vídeo de outra plataforma pela API?

O caminho é subir o arquivo: você reserva o slot com POST /v1/videos/uploads/reserve e manda o arquivo pro endpoint de upload assinado que volta. A partir daí o vídeo é seu na Moviie, com embed, IA e webhook. A API dirige o ciclo do vídeo que está na plataforma.

Próximo passo

Tira o vídeo da tela.Põe no seu backend.

14 dias de trial pra reservar um upload, mandar gerar os materiais e receber o webhook assinado no seu endpoint. OpenAPI e exemplos prontos, contrato inteiro em docs.moviie.ai. Sem ligação de vendas.

Testar 14 dias grátis Agendar demo guiada

REST /v1 com OpenAPI Geração de IA por API Webhook assinado com retry