Automatiza Medios IA con Kubeez: REST API vs MCP

Los equipos creativos rara vez quieren que cada activo comience con un clic manual. La automatización —trabajos por lotes, herramientas internas y asistentes IA que "ejecutan el brief"— necesita interfaces estables. Kubeez te ofrece dos: una API REST pública para servidores y scripts, y un servidor Model Context Protocol (MCP) para clientes IA que hablan herramientas.

Esta guía explica cuándo usar cuál, cómo encajan en flujos de trabajo comunes y a dónde ir en el producto y la documentación.

#Por qué la automatización importa para imagen, video y audio

Los pipelines de marketing y producción repiten la misma forma: elige un modelo, pasa un prompt (y a veces medios de referencia), espera un trabajo, luego entrega URLs o archivos. Hacer eso solo a través de un navegador no escala para CI, herramientas de back-office o flujos de trabajo agénticos donde un modelo decide el siguiente paso.

Kubeez expone la misma superficie de generación que usas en la app —medios, música, anuncios y lecturas de cuenta— a través de integraciones diseñadas para máquinas (REST) y para asistentes que usan herramientas (MCP).

#Un poco de contexto: qué es MCP

El Model Context Protocol es un estándar abierto para conectar aplicaciones LLM a herramientas, prompts y recursos. La especificación describe hosts, clientes y servidores y cómo coordinan capacidades como herramientas invocables. Consulta la especificación del Model Context Protocol para una visión general autorizada.

El servidor MCP de Kubeez no es un reemplazo para REST; es la opción adecuada cuando el llamador es un asistente IA que descubre herramientas y dirige trabajos a través de tu cuenta.

#Dos puertas de entrada en Kubeez

#API REST: backends, scripts y claves de larga duración

Usa la API REST cuando controlas un servidor o script y quieres autenticación con clave API — típico para backends, trabajos programados o apps móviles.

• URL base: https://api.kubeez.com/v1
• Claves: crea y gestiona claves en Claves API (secretos estilo sk_live_…).
• Flujo típico de medios: GET /v1/models → opcional POST /v1/upload/media para archivos locales → POST /v1/generate/media → sondea GET /v1/generate/media/{id} hasta completado.

Orientación completa: Descripción general de la API REST y Swagger UI para referencia interactiva.

#MCP: asistentes, OAuth y tokens de acceso personal

Usa MCP cuando el llamador es un asistente IA o host MCP (por ejemplo Cursor u otros clientes que se conectan a servidores MCP remotos).

• URL del servidor: https://mcp.kubeez.com/mcp
• OAuth (recomendado): el cliente abre un navegador; inicias sesión en Kubeez y apruebas capacidades.
• Token de acceso personal: para productos que solo ofrecen un campo de "clave API", genera un token en configuración de MCP.

Conceptos y configuración: Descripción general de MCP y Inicio rápido.

#Cuándo elegir REST vs MCP

Prefiere REST cuando necesitas código del lado del servidor predecible, CI, webhooks o integraciones que no son de asistente.

Prefiere MCP cuando el flujo de trabajo del usuario es conversacional — le piden a un asistente "generar tres variantes" o "revisar el saldo y elegir un modelo de video".

Secretos: Las claves API son de larga duración y pertenecen a vaults; el OAuth de MCP reduce los secretos pegados para clientes interactivos, mientras que los tokens de acceso personal funcionan para hosts que solo aceptan un token estático.

#Patrones de automatización que encajan bien

• Lotes nocturnos o de campaña — REST desde un trabajador: recorre prompts, respeta límites de velocidad, persiste IDs de trabajo, sondea hasta completar.
• Ganchos internos de administración o DAM — REST desde tu backend después de que un paso de aprobación desencadena la generación.
• Copilotos creativos — MCP para que el asistente llame get_models, generate_media y get_generation_status en un bucle alineado con tus instrucciones.
• Híbrido — prototipa con MCP en el IDE, luego reimplementa la misma secuencia en REST para servicios de producción.

#Dónde empezar en el producto

• Video y movimiento: Generación de video
• Imágenes estáticas y ediciones: Generación de medios
• Claves API: Claves API
• Conexión MCP y PAT: Configuración de MCP

Resumen: Kubeez soporta trabajo creativo programático a través de REST (https://api.kubeez.com/v1) y trabajo impulsado por asistentes a través de MCP (https://mcp.kubeez.com/mcp). Elige REST para servidores y scripts; elige MCP cuando un cliente IA deba orquestar herramientas en tu nombre. Lee la descripción general de la API REST y la descripción general de MCP, luego lanza tu primer trabajo automatizado.