FilmeeAi

npx add-mcp 'https://filmee.app/mcp'

REST API para desenvolvedores

Do servidor do seu aplicativo ou serviço, você pode chamar a edição de vídeo e a geração de animação do FilmeeAi como componentes. Os usuários do seu aplicativo não precisam se registrar no FilmeeAi. O uso é descontado dos créditos da sua conta FilmeeAi que emitiu a chave de API.

Funcionalidades disponíveis

Inserção automática de animação explicativa	Lê o conteúdo falado e insere animações adequadas (layout e estilo podem ser especificados)
Gravação de legendas	Cria legendas a partir da transcrição e as grava no vídeo (normal / palavra por palavra)
Pele bonita	Correção de pele, brilho e contorno (fraco / padrão / forte)
BGM	Insere automaticamente música livre de direitos autorais sob a voz (volume e gênero podem ser especificados)
Corte de silêncio no início e fim	Remove automaticamente o silêncio no início e no fim da fala (sempre ativo, gratuito)
Geração de vídeo de animação	Cria vídeos de animação com narração, BGM e legendas a partir de texto (1/3/5/10 minutos)

Cada funcionalidade pode ser ativada ou desativada individualmente. Se explainer_animation for definido como false, nem a divisão de cenas por IA nem a geração de animação serão realizadas, permitindo usos como "apenas pele bonita" ou "apenas legendas".

Como usar

1. Emita uma chave de API na página da conta (a chave é exibida apenas uma vez no momento da emissão). Página da conta
2. Envie um link direto para o arquivo de vídeo e solicite o acabamento.

   curl -X POST https://filmee.app/api/v1/talk-videos \
     -H "Authorization: Bearer $FILMEEAI_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "video_url": "https://example.com/my-talk.mp4",
       "explainer_animation": true,
       "subtitles": true,
       "beautify": true,
       "beautify_level": "normal",
       "language": "ja",
       "webhook_url": "https://your-app.example.com/filmeeai/webhook"
     }'
   

Exemplo apenas com pele bonita: curl -X POST https://filmee.app/api/v1/talk-videos \ -H "Authorization: Bearer $FILMEEAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "video_url": "https://example.com/my-talk.mp4", "explainer_animation": false, "subtitles": false, "beautify": true, "beautify_level": "strong" }' 3. Verifique o status (gratuito). Se webhook_url for especificado, você receberá uma notificação quando concluído. curl https://filmee.app/api/v1/videos/talk_Ab12Cd34Ef56 \ -H "Authorization: Bearer $FILMEEAI_API_KEY" 4. Quando o status estiver completed, receba o vídeo finalizado. A cobrança ocorre apenas na primeira chamada e, a partir da segunda, o mesmo URL é retornado gratuitamente. curl -X POST https://filmee.app/api/v1/videos/talk_Ab12Cd34Ef56/result \ -H "Authorization: Bearer $FILMEEAI_API_KEY"

Criar vídeo de animação

curl -X POST https://filmee.app/api/v1/anime-videos \
  -H "Authorization: Bearer $FILMEEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "A shy robot learns to make friends", "length_minutes": 1, "language": "en" }'

Preços

Os mesmos valores de crédito da Web. Vídeos de fala custam 12 créditos por minuto + 1 para legendas, 2 para pele bonita, 2 para BGM (arredondado por minuto). Vídeos de animação custam 100 créditos por 1 minuto, 250 por 3 minutos, 400 por 5 minutos e 700 por 10 minutos. Trabalhos com falha não são cobrados. O saldo pode ser verificado com GET /account.

Limites

• Vídeos de fala: até 15 minutos e 2GB. URLs de páginas do YouTube / TikTok / Instagram / Vimeo não podem ser lidas (envie um link direto para o arquivo)
• Vídeos que podem ser iniciados: 10 por hora por conta, com até 3 vídeos de fala processados simultaneamente
• Solicitações de API: até 120 por minuto por chave (acima disso, retorna 429 e Retry-After)
• O status de trabalhos de vídeo de fala desaparece cerca de 6 horas após a conclusão. Receba o result antes disso
• Os URLs de vídeo recebidos não têm garantia de período de armazenamento. Salve em seu próprio armazenamento

Webhook (notificação de conclusão)

Quando concluído (video.completed) ou com falha (video.failed), um POST é enviado para webhook_url. O corpo não inclui o URL do vídeo. Verifique a assinatura no cabeçalho FilmeeAi-Signature usando o segredo do webhook exibido na emissão da chave. As notificações são de melhor esforço (reenvio até 3 vezes), então a fonte da verdade do status é sempre GET /videos/{id}.

import crypto from "node:crypto";

// header = req.headers["filmeeai-signature"]  (t=...,v1=...)
export function verify(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const expected = crypto
    .createHmac("sha256", secret)
    .update(\`${parts.t}.${rawBody}\`)
    .digest("hex");
  const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 ?? ""));
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  return ok && fresh;
}

Erros

Erros são retornados no formato { "error": { "code": "...", "message": "..." } }. Principais códigos: missing_api_key / invalid_api_key (401), invalid_parameters / invalid_video_url (400), insufficient_credits (402), video_not_found (404), not_ready / video_failed (409), rate_limited / job_rate_limited / too_many_active_jobs (429).

Avisos de uso

Ao processar vídeos com pessoas, envie apenas aqueles com consentimento das pessoas visíveis. Não é permitido usar para conteúdo ilegal ou que viole direitos.

Especificação (OpenAPI)

https://filmee.app/api/v1/openapi.json

Uso a partir de agentes de IA (MCP)

O que é possível

Basta pedir ao agente "crie uma animação de 1 minuto do Momotaro" e o FilmeeAi criará um vídeo de animação com narração, BGM e legendas, retornando um link para visualização. Sua conta FilmeeAi e créditos habituais são usados.

URL de conexão

https://filmee.app/mcp

A autenticação é via OAuth (seu login FilmeeAi). Não é necessário colar chave de API; a tela de login aparece na conexão.

Adicionar ao Claude (Web / Desktop / Celular)

1. Nas configurações do Claude, abra "Personalizar" → "Conectores"
2. Selecione "Adicionar conector personalizado"
3. No nome, coloque FilmeeAi e, no URL, insira o URL de conexão acima e adicione
4. Pressione "Conectar" e permita na tela de login do FilmeeAi
5. No chat, ative FilmeeAi em "+" → "Conectores"

Adicionar ao Claude Code

Execute o seguinte no terminal e faça login no navegador na primeira vez.

claude mcp add --transport http filmeeai https://filmee.app/mcp

Cursor, ChatGPT e outros

Se o cliente for compatível com MCP Streamable HTTP, você pode registrar o URL de conexão acima diretamente.

Lista de ferramentas

Ferramenta	Função	Cobrança
get_credit_balance	Verificar saldo de créditos e plano	Gratuito
create_anime_video	Iniciar geração de vídeo a partir de um resumo (1/3/5/10 minutos)	Gratuito (no início)
get_video_status	Verificar o progresso da geração	Gratuito
get_video_link	Obter URL de visualização e compartilhamento do vídeo concluído	Consome créditos apenas na primeira vez
list_my_videos	Listar seus vídeos concluídos	Gratuito
create_talk_video_from_url	Enviar URL de vídeo de fala gravado e aplicar corte de silêncio no início/fim (gratuito), legendas, pele bonita (com intensidade), BGM (volume/gênero), fala acelerada, zoom, inserção de animação explicativa (até 15 min/2GB)	Gratuito (no início)
get_talk_video_status	Verificar o progresso da edição de vídeo de fala	Gratuito
get_talk_video_link	Obter URL de visualização e compartilhamento do vídeo de fala concluído	Consome créditos apenas na primeira vez

Créditos

Os mesmos preços da Web. A cobrança ocorre apenas quando o vídeo é recebido via get_video_link; se a geração falhar, não há consumo.

1 minuto	100 créditos
3 minutos	250 créditos
5 minutos	400 créditos
10 minutos	700 créditos

Vídeos de fala custam 12 créditos por minuto, mais legendas +1, pele bonita +2, BGM +2 (todos por minuto), com arredondamento por minuto. O vídeo é enviado por link direto ao arquivo (páginas do YouTube não podem ser lidas).

O plano gratuito oferece 200 créditos por mês. Adicionais na página de preços.

Tratamento de dados

Do agente, recebemos apenas as entradas passadas às ferramentas (resumo, configurações, ID do trabalho). Não recebemos conteúdo de conversas ou arquivos. Para o período de armazenamento dos itens gerados e o compartilhamento com terceiros, consulte a política de privacidade; para condições de uso, consulte os termos de serviço.

Suporte

Se não conseguir conectar, entre em contato pelo formulário de contato.