TransformeClaudeClaudeem um motor de videoclipes

Conecte a freebeat ao Claude, Cursor, Windsurf e Claude Code, e gere videoclipes e efeitos de IA diretamente das suas conversas.

API Keys
1

Abra a configuração do Claude Desktop

Inicie o Claude Desktop e abra a configuração local do servidor MCP.
Claude Desktop
2

Adicione o servidor MCP freebeat

Nomeie como freebeat e adicione o comando local do servidor MCP:
3

Defina FREEBEAT_API_KEY

Crie uma API Key na freebeat, adicione-a ao ambiente MCP e peça ao Claude para iniciar uma tarefa de videoclipe.
API Keys → Perfil

O CONJUNTO DE COMANDOS

auth

Salve e confira sua API Key freebeat localmente, ou passe --api-key por comando quando necessário.

set-api-keyshow--api-key

assets

Envie áudio de um arquivo local ou URL de origem, e envie uma ou duas imagens de referência.

upload-audioupload-imagemusic_id

effects

Liste efeitos de vídeo disponíveis e confira effect_id, previews, música padrão e proporções.

listeffect_idpreview

mv

Envie ou execute geração de videoclipe IA a partir de música enviada, prompt, referências e proporção.

submitrun--json

effect

Gere clipes de template de efeito com effect_id, music_id, URL de imagem e prompt.

submitruneffect_id

task

Verifique status, aguarde conclusão e recupere video_url e cover_url de tarefas concluídas.

statuswaitresult

UM ESTÚDIO COMPLETO DE VIDEOCLIPES DENTRO DO CLAUDE

Geração de videoclipes, efeitos de IA, upload de mídia e gestão de tarefas em uma só conexão

Terminal

> Gere um videoclipe cidade neon para esta faixa

--aspect 9:16

--reference cover.png

 

● freebeat

Enviando áudio...

Criando tarefa de videoclipe...

→ ./output/neon_mv.mp4

MÍDIA GENERATIVA

GERAÇÃO DE VIDEOCLIPES

Comece com uma música, prompt ou link musical e deixe seu agente chamar a freebeat para gerar um MV completo com proporções, referências, efeitos e resultados de render assíncronos.

MOTOR DE EFEITOS

UM PROMPT TRANSFORMA MÚSICA EM SHORTS

Peça ao seu agente para encontrar o efeito de vídeo certo, preencher música, imagens de referência e prompts, e gerar clipes prontos para campanhas e redes sociais.

Agente

> Encontre efeitos para um teaser de lançamento

 

● freebeat

8 efeitos encontrados.

Gerando 3 variantes de vídeo...

✓ teaser vertical

✓ clipe social quadrado

Modos

upload_audio Importar áudio ou URL de origem

upload_image Adicionar uma ou duas referências

list_effects Ver opções de effect_id

generate_music_video Iniciar tarefa MV

generate_effect Iniciar tarefa de efeito

get_task_status Consultar status da tarefa

get_task_result Obter video_url + cover_url

MODOS

ESCOLHA UM EFEITO, PULE A CONFIGURAÇÃO

Comece por effect_id, música padrão, referências recomendadas e instruções de template. Seu agente pode comparar templates antes de gerar.

AUTOMAÇÃO

DA PASTA DE MÚSICAS AO PIPELINE DE VÍDEO

CLI e MCP compartilham o mesmo modelo de tarefas. Use Claude para planejar a criação e depois faça upload em lote, gere, aguarde e salve JSON estruturado por scripts no terminal.

Terminal

> Crie 5 videoclipes de ./songs

 

● freebeat

Lendo pasta...

Enviando jobs...

✓ 5 task ids salvos

✓ results.json pronto

UM ESTÚDIO COMPLETO DE VIDEOCLIPES DENTRO DO SEU AGENTE

Upload de áudio, referências de imagem, templates de efeitos e resultados de render em uma conexão MCP

Terminal

$ freebeat assets upload-audio --file song.mp3

$ freebeat assets upload-image cover.png

$ freebeat mv run --audio song.mp3 --image cover.png --prompt "neon city performance" --json

 

● freebeat

Enviando áudio e imagem de referência...

Criando tarefa de videoclipe...

 

✓ music_id 123

✓ task_id task-8H4n2

✓ status pending

 

✓ JSON pronto para polling

Todos os assets musicais

Transforme qualquer URL de música, arquivo de áudio local, referência de produto ou briefing de campanha em um workflow de vídeo completo.

Terminal

$ freebeat effects list --json

$ freebeat effect run --effect-id 12 --prompt "kinetic neon chorus" --json

 

→ carregando templates de efeito...

 

● freebeat

 

effect_id 12 selecionado

image_url padrão selecionada

music_id padrão

prompt kinetic neon chorus

 

payload da tarefa pronto

Seu estilo em cada prompt

Imagens de referência e prompts reutilizáveis mantêm a direção visual consistente entre MV e geração de efeitos.

Terminal

$ freebeat task wait task-8H4n2

$ freebeat task result task-8H4n2 --json

 

● freebeat

status pending → completed

 

✓ video_url https://cdn.freebeat.ai/...

✓ cover_url https://cdn.freebeat.ai/...

✓ metadata.json escrito

Resultados prontos para automação

Task IDs, verificações de status, URLs de vídeo, URLs de capa e erros estruturados são retornados para scripts e agentes.

Terminal

$ freebeat assets upload-audio --file ./songs/track-01.mp3

$ freebeat mv submit --music-id 123 --prompt "vertical release cut" --json

 

● freebeat

Lendo metadados de origem...

Enviando tarefas assíncronas de videoclipe...

 

✓ task_id task-101

✓ task_id task-102

✓ results.json pronto

Variantes de videoclipes em escala

Gere cortes de campanha, loops curtos e versões com efeitos mantendo cada resultado organizado para publicação.

DO CONCEITO AO CONTEÚDO EM UMA CONVERSA

Diga ao Claude o que você está criando. Ele escolhe as ferramentas MCP da freebeat certas e entrega resultados de videoclipe prontos para produção

DA IDEIA AO VIDEOCLIPE EM UMA CONVERSA

Comece pequeno com uma geração ou avance com descoberta de efeitos, referências, batch jobs e polling de tarefas. Claude cuida do workflow

Criação de assets

Envie uma tarefa de videoclipe em segundos

Descreva o mood, a proporção e a fonte musical. Claude escolhe a ferramenta MCP freebeat e retorna o task_id.

Gere um MV cyberpunk 9:16 para esta faixa
Produção completa

Monte um pacote de lançamento em uma conversa

Crie um MV principal, um corte quadrado e variações curtas mantendo a mesma direção visual.

Faça três cortes sociais e salve todos os links de vídeo
Automação

Compare efeitos e entregue o melhor resultado

Liste efeitos freebeat, gere variantes, aguarde a conclusão e escolha a saída mais forte.

Teste 4 efeitos e mostre os vídeos concluídos

AINDA TEM PERGUNTAS?

Respondemos às perguntas mais frequentes

Como a freebeat se conecta a agentes de IA?

Adicione o servidor MCP freebeat a qualquer cliente compatível com MCP. O comando é npx -y freebeat-mcp, autorizado pela variável de ambiente FREEBEAT_API_KEY.

Onde crio uma API Key?

Entre na freebeat e abra /music-video-generator/profile. Crie uma chave na seção API Keys. O link API Keys desta página aponta para lá.

Quais agentes são compatíveis?

Claude Desktop, Cursor, Windsurf, Claude Code e outros clientes compatíveis com MCP podem usar a mesma configuração de servidor freebeat.

Qual é a diferença entre MCP e CLI?

MCP é para conversas com agentes. CLI é para terminais e scripts. Ambos expõem uploads, efeitos, geração, polling e recuperação de resultados.

Por que jobs de geração exigem polling?

Renderizar um videoclipe pode levar tempo. A freebeat retorna primeiro um task_id; depois o agente ou a CLI consulta o status e busca video_url quando concluir.

O que posso criar?

Você pode criar videoclipes, clipes com templates de efeitos, vídeos sociais verticais, MVs widescreen e versões guiadas por estilo usando imagens de referência.

Preciso colocar minha API Key nos prompts?

Não. Mantenha a chave na configuração de ambiente MCP ou nas credenciais da CLI. Seu prompt deve descrever apenas a tarefa criativa.

Posso usar o resultado em automação?

Sim. Tarefas concluídas retornam links e campos de status estruturados que funcionam bem com JSON, planilhas, calendários de conteúdo e scripts.

SEU STACK DE IA SUBIU DE NÍVEL

Conecte Claude, Cursor, Windsurf ou Claude Code à freebeat em segundos. Videoclipes, efeitos de IA e resultados de render sob demanda.

Começar

EXPLORE MAIS RECURSOS DE IA