Convierte
Claudeen un motor de videoclips
Conecta freebeat con Claude, Cursor, Windsurf y Claude Code, y genera videoclips y efectos IA directamente desde tus conversaciones.
Añade el servidor MCP de freebeat
Define FREEBEAT_API_KEY
EL CONJUNTO DE COMANDOS
auth
Guarda e inspecciona tu API Key de freebeat localmente, o pasa --api-key por comando cuando haga falta.
assets
Sube audio desde un archivo local o una URL de origen, y sube una o dos imágenes de referencia.
effects
Lista efectos de video disponibles e inspecciona effect_id, vista previa, música predeterminada y formatos.
mv
Envía o ejecuta generación de videoclips IA desde una canción subida, prompt, referencias y formato.
effect
Genera clips de plantilla de efecto con effect_id, music_id, URL de imagen y prompt.
task
Consulta estado, espera finalización y recupera video_url y cover_url de tareas completadas.
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
> 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.
> Busca efectos para un teaser de lanzamiento
● freebeat
Se encontraron 8 efectos.
Generando 3 variantes de video...
✓ teaser vertical
✓ clip social cuadrado
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.
> 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
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
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.
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.
Compara efectos y publica el mejor resultado
Lista efectos de freebeat, genera variantes, espera a que terminen y elige la salida más fuerte.
¿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


