Precios
30% DTO

ConvierteClaudeClaudeen un motor de videoclips

Conecta freebeat con Claude, Cursor, Windsurf y Claude Code, y genera videoclips y efectos IA directamente desde tus conversaciones.

API Keys
1

Abre la configuración de Claude Desktop

Inicia Claude Desktop y abre la configuración local del servidor MCP.
Claude Desktop
2

Añade el servidor MCP de freebeat

Llámalo freebeat y añade el comando del servidor MCP local:
3

Define FREEBEAT_API_KEY

Crea una API Key en freebeat, añádela al entorno MCP y pide a Claude que inicie una tarea de videoclip.
API Keys → Perfil

EL CONJUNTO DE COMANDOS

auth

Guarda e inspecciona tu API Key de freebeat localmente, o pasa --api-key por comando cuando haga falta.

set-api-keyshow--api-key

assets

Sube audio desde un archivo local o una URL de origen, y sube una o dos imágenes de referencia.

upload-audioupload-imagemusic_id

effects

Lista efectos de video disponibles e inspecciona effect_id, vista previa, música predeterminada y formatos.

listeffect_idpreview

mv

Envía o ejecuta generación de videoclips IA desde una canción subida, prompt, referencias y formato.

submitrun--json

effect

Genera clips de plantilla de efecto con effect_id, music_id, URL de imagen y prompt.

submitruneffect_id

task

Consulta estado, espera finalización y recupera video_url y cover_url de tareas completadas.

statuswaitresult

UN ESTUDIO COMPLETO DE VIDEOCLIPS DENTRO DE CLAUDE

Generación de videoclips, efectos IA, subida de medios y gestión de tareas en una sola conexión

Terminal

> Genera un videoclip de ciudad neón para esta pista

--aspect 9:16

--reference cover.png

 

● freebeat

Subiendo audio...

Creando tarea de videoclip...

→ ./output/neon_mv.mp4

MEDIOS GENERATIVOS

GENERACIÓN DE VIDEOCLIPS

Empieza con una canción, un prompt o un enlace musical y deja que tu agente llame a freebeat para generar un MV completo con formatos, referencias, efectos y resultados de render asíncronos.

MOTOR DE EFECTOS

UN PROMPT CONVIERTE MÚSICA EN SHORTS

Pide a tu agente que encuentre el efecto correcto, complete música, imágenes de referencia y prompts, y genere clips listos para campañas y redes sociales.

Agente

> Busca efectos para un teaser de lanzamiento

 

● freebeat

Se encontraron 8 efectos.

Generando 3 variantes de video...

✓ teaser vertical

✓ clip social cuadrado

Modos

upload_audio Importar audio o URL de origen

upload_image Añadir una o dos referencias

list_effects Ver opciones de effect_id

generate_music_video Iniciar tarea MV

generate_effect Iniciar tarea de efecto

get_task_status Consultar estado de tarea

get_task_result Obtener video_url + cover_url

MODOS

ELIGE UN EFECTO Y SALTA LA CONFIGURACIÓN

Empieza desde effect_id, música predeterminada, referencias recomendadas e instrucciones de plantilla. Tu agente puede comparar plantillas antes de generar.

AUTOMATIZACIÓN

DE CARPETA DE CANCIONES A PIPELINE DE VIDEO

CLI y MCP comparten el mismo modelo de tareas. Usa Claude para planear la creatividad y luego sube, genera, espera y guarda JSON estructurado desde scripts de terminal.

Terminal

> Crea 5 videoclips desde ./songs

 

● freebeat

Leyendo carpeta...

Enviando trabajos...

✓ 5 task ids guardados

✓ results.json listo

UN ESTUDIO COMPLETO DE VIDEOCLIPS DENTRO DE TU AGENTE

Subida de audio, referencias de imagen, plantillas de efectos y resultados de render en una sola conexión 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

Subiendo audio e imagen de referencia...

Creando tarea de videoclip...

 

✓ music_id 123

✓ task_id task-8H4n2

✓ status pending

 

✓ JSON listo para polling

Todos tus assets musicales

Convierte cualquier URL de canción, audio local, referencia de producto o brief de campaña en un flujo de video terminado.

Terminal

$ freebeat effects list --json

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

 

→ cargando plantillas de efecto...

 

● freebeat

 

effect_id 12 seleccionado

image_url predeterminada seleccionada

music_id predeterminado

prompt kinetic neon chorus

 

payload de tarea listo

Tu estilo dentro de cada prompt

Las imágenes de referencia y los prompts reutilizables mantienen una dirección visual consistente en MV y efectos.

Terminal

$ freebeat task wait task-8H4n2

$ freebeat task result task-8H4n2 --json

 

● freebeat

estado pending → completed

 

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

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

✓ metadata.json escrito

Resultados listos para automatizar

Task IDs, estados, URLs de video, URLs de portada y errores estructurados se devuelven para scripts y agentes.

Terminal

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

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

 

● freebeat

Leyendo metadatos de origen...

Enviando tareas asíncronas de videoclip...

 

✓ task_id task-101

✓ task_id task-102

✓ results.json listo

Variantes de videoclips a escala

Genera cortes de campaña, loops cortos y versiones con efectos manteniendo cada resultado organizado para publicar.

DEL CONCEPTO AL CONTENIDO EN UNA CONVERSACIÓN

Dile a Claude qué quieres crear. Elegirá las herramientas MCP de freebeat adecuadas y entregará resultados de videoclip listos para producción

DE IDEA A VIDEOCLIP EN UNA CONVERSACIÓN

Empieza con una generación simple o profundiza con búsqueda de efectos, referencias, trabajos por lote y polling de tareas. Claude gestiona el flujo

Creación de assets

Envía una tarea de videoclip en segundos

Describe el estado de ánimo, el formato y la fuente musical. Claude elige la herramienta MCP de freebeat y devuelve el task_id.

Genera un MV cyberpunk 9:16 para esta pista
Producción completa

Construye un paquete de lanzamiento desde una conversación

Crea un MV principal, un corte cuadrado y variaciones cortas manteniendo la misma dirección visual.

Haz tres cortes sociales y guarda todos los enlaces de video
Automatización

Compara efectos y publica el mejor resultado

Lista efectos de freebeat, genera variantes, espera a que terminen y elige la salida más fuerte.

Prueba 4 efectos y muéstrame los videos completados

¿TIENES MÁS PREGUNTAS?

Hemos respondido las preguntas más frecuentes

¿Cómo se conecta freebeat con agentes IA?

Añade el servidor MCP de freebeat a cualquier cliente compatible con MCP. El comando es npx -y freebeat-mcp y se autoriza con la variable de entorno FREEBEAT_API_KEY.

¿Dónde creo una API Key?

Inicia sesión en freebeat y abre /music-video-generator/profile. Crea una clave en la sección API Keys. El enlace API Keys de esta página apunta allí.

¿Qué agentes son compatibles?

Claude Desktop, Cursor, Windsurf, Claude Code y otros clientes compatibles con MCP pueden usar la misma configuración de servidor freebeat.

¿Cuál es la diferencia entre MCP y CLI?

MCP es para conversaciones con agentes. CLI es para terminales y scripts. Ambos exponen subidas, efectos, generación, polling y recuperación de resultados.

¿Por qué las generaciones requieren polling?

Renderizar un videoclip puede tomar tiempo. freebeat devuelve primero un task_id; después el agente o la CLI consulta el estado y obtiene video_url al completarse.

¿Qué puedo crear?

Puedes crear videoclips, clips con plantillas de efectos, videos sociales verticales, MV panorámicos y versiones guiadas por estilo usando imágenes de referencia.

¿Debo poner mi API Key en los prompts?

No. Mantén la clave en la configuración de entorno MCP o en las credenciales de CLI. Tu prompt solo debe describir la tarea creativa.

¿Puedo usar el resultado en automatizaciones?

Sí. Las tareas completadas devuelven enlaces y campos de estado estructurados que funcionan bien con JSON, hojas de cálculo, calendarios de contenido y scripts.

TU STACK IA SUBE DE NIVEL

Conecta Claude, Cursor, Windsurf o Claude Code con freebeat en segundos. Videoclips, efectos IA y resultados de render bajo demanda.

Empezar

EXPLORA MÁS FUNCIONES IA