FacelessGenie
Entrar
Produto9 de jul. de 2026 · 9 min de leitura

API de vídeo com IA para criar vídeos por código ou Claude

Crie um vídeo com uma única requisição, acompanhe o progresso e baixe o MP4 pronto. Este guia mostra o fluxo das requisições, o conector do Claude e três automações úteis.

FG
Equipe editorial FacelessGenie
Time de produto · Atualizado em 9 de jul. de 2026
Um fluxo de criação de vídeos sem aparecer sendo comandado por requisições de API

Fazer um vídeo no painel é simples. Fazer trinta escancara cada etapa repetitiva: abrir o formulário, colar o próximo tema, escolher as mesmas configurações, enviar e voltar depois para pegar o arquivo. A API de vídeo com IA existe para o momento em que essa repetição vira o trabalho em si.

Há duas formas de usar. Quem programa pode chamar a API REST diretamente. Quem prefere conversar pode conectar o Claude e pedir vídeos em linguagem natural. As duas usam os mesmos formatos, o mesmo saldo da conta e a mesma biblioteca de vídeos prontos do app principal.

O que foi lançado

  • Uma API REST em /api/v1 para criar vídeos, acompanhar o progresso, ver o custo em créditos antes, enviar arquivos e gerenciar o que já ficou pronto.
  • Um conector MCP para pedir o mesmo trabalho pelo Claude, Claude Code, Cursor ou outro cliente compatível.
  • Login com a sua conta no app do Claude, sem copiar uma chave de API pessoal para o chat.
  • Chaves de API pessoais para integrações por código, criadas e revogadas em Configurações.

Como a API funciona

A criação de vídeo é assíncrona. Faça um POST com topic e formatId para /api/v1/videos, e a resposta devolve na hora o id do vídeo e o custo em créditos. Use esse id para acompanhar o progresso enquanto o vídeo é feito. Quando o status virar COMPLETED, a resposta traz a URL do MP4 pronto.

  1. 1POST /api/v1/videos com { topic, formatId }. A resposta 202 traz o id do vídeo e o creditsCost.
  2. 2GET /api/v1/videos/{id} mais ou menos a cada minuto. O status passa por PENDING, PROCESSING e RENDERING.
  3. 3Quando o status for COMPLETED, videoUrl é o seu vídeo pronto. Baixe, poste ou passe para a próxima etapa do seu fluxo.
Um pedido com um tema passando por roteiro, voz, imagens, legendas, música e renderização até virar um vídeo vertical pronto
Uma requisição liga a linha de produção; um endpoint de status avisa quando o vídeo está pronto.

GET /api/v1/formats devolve os formatos disponíveis e os campos que cada um aceita. Isso inclui opções de duração, campos específicos de cada formato e vagas de elenco para vídeos com personagem. Você pode manter os modelos padrão recomendados ou escolher os modelos de roteiro, voz, imagem, animação e música quando um fluxo pedir mais controle.

Criando vídeos pelo Claude

O conector MCP é o caminho sem código. Adicione o conector no Claude, entre com a sua conta e descreva o vídeo que você quer. O Claude consegue listar formatos adequados, mostrar o custo em créditos, criar o vídeo, acompanhar o progresso e devolver o link pronto na conversa.

“Faça um short de 60 segundos sobre cinco criaturas do fundo do mar que parecem inventadas, com música misteriosa, em 1080p.”
— Um bom pedido traz o tema, a duração, o clima e a qualidade de saída.

O conector também lista vozes, mostra o seu saldo, apaga vídeos que você não quer mais e envia referências de personagem ou músicas. O Claude Code e o Cursor usam uma chave de API pessoal para as mesmas ferramentas.

Três receitas de automação

1. O canal da lista de temas

Guarde os temas aprovados numa planilha do Google ou num banco de dados do Notion. Um fluxo agendado no n8n ou no Zapier pode ler a próxima linha, criar o vídeo, esperar terminar e colocar o MP4 numa pasta de revisão. Mantenha uma etapa de aprovação humana antes de publicar; a automação é boa para mover trabalho, não para decidir se um vídeo vale a pena ser postado.

2. O reaproveitamento de conteúdo

Alguns formatos aceitam uma URL de origem. Um script pode monitorar o seu próprio feed RSS, passar a URL de um artigo novo em formatInputs e criar um rascunho de vídeo a partir dele. O mesmo esquema funciona para newsletters e novidades de produto que são suas. Revise o roteiro antes de publicar, principalmente quando a fonte tem citações, datas ou números que podem precisar de contexto.

3. O Claude como produtor

O Claude é útil quando o fluxo ainda precisa de critério. Planeje uma semana de temas numa conversa, compare formatos e custos e depois crie os vídeos um por vez. Você pode revisar cada resultado antes de decidir se o próximo tema merece o mesmo tratamento.

Cartões de temas, um artigo e uma conversa virando uma fileira de vídeos verticais prontos
Uma lista de temas, um feed de artigos ou uma conversa podem comandar o mesmo fluxo de vídeo.

Preço e controle da conta

O acesso à API está incluído em todos os planos pagos, sem assinatura de API separada. Os vídeos usam o mesmo preço em créditos do painel. Antes de criar um, chame POST /api/v1/videos/preview-credits com o formato e as configurações que você pretende usar para ver o custo exato.

EndpointO que faz
POST /videosCria um vídeo a partir de um tema e devolve o id e o custo exato
GET /videos/{id}Confere o status e devolve o MP4 pronto
POST /videos/preview-creditsCusto exato antes de criar
GET /formats, /models, /voicesLê as opções de produção disponíveis
POST /assets/presignEnvia as suas referências de personagem e músicas
GET /accountPlano e saldo de créditos atual

Chaves pessoais podem ser revogadas em Configurações, e conexões do Claude podem ser desconectadas pela conta que as aprovou. O extrato de créditos mostra as cobranças de criação e os reembolsos automáticos de renderizações que falharam.

Comece em 5 minutos

  1. 1Abra Configurações, vá em API e crie uma chave pessoal. Para o Claude, use o fluxo do conector.
  2. 2Chame GET /api/v1/formats para escolher um formato, ou comece com ai-images-short.
  3. 3Envie o seu primeiro tema com POST para /api/v1/videos e consulte até ficar COMPLETED.
  4. 4Use a referência dos endpoints quando precisar de campos opcionais, envio de arquivos ou um exemplo de requisição para copiar e colar.

Perguntas frequentes

Não. O acesso à API está incluído em todos os planos pagos e gasta os mesmos créditos do painel, pelos mesmos preços. Veja o custo de qualquer vídeo com POST /videos/preview-credits antes de criar.

Comece agora

Publique hoje o seu primeiro vídeo sem aparecer.

Escolha o nicho e os modelos, e a gente renderiza. Da ideia ao Short pronto em menos de 7 minutos, sem câmera e sem editor.

Continue lendo