Use Clipia con agentes de IA

Clipia es una plataforma de generación multimedia con IA que los agentes pueden manejar directamente sobre un catálogo de más de 60 modelos de imagen y vídeo. A través del servidor MCP remoto en https://mcp.clipia.ai/mcp, un agente puede generar vídeo a partir de texto o de una imagen inicial, crear o editar imágenes, producir voz y música, montar vídeos de varias escenas, crear presentaciones, consultar los modelos disponibles, seguir las tareas y devolver los archivos terminados a la conversación. Para flujos de imagen y vídeo propios de su aplicación, llame a la API REST o a un SDK oficial.

Elija entre MCP y la API REST

MCP y REST utilizan la misma cuenta de Clipia, el mismo saldo de créditos y el mismo historial de generaciones allí donde sus capacidades coinciden. MCP no tiene ningún recargo aparte.

Herramientas disponibles para los agentes de IA

El perfil completo incluye 15 herramientas que el agente puede invocar. La tarjeta del servidor y la respuesta de tools/list son la referencia para el entorno de ejecución actual: las 10 herramientas básicas están siempre presentes, mientras que otras cinco aparecen cuando están activadas las capacidades de producto correspondientes.

10 herramientas básicas

• generate_image — genera o edita imágenes a partir de un prompt y referencias opcionales
• generate_video — crea vídeo a partir de texto o de una imagen inicial
• generate_audio — convierte texto en voz
• generate_music — crea música de fondo o una banda sonora
• wait_generation — hace long-polling de una tarea asíncrona hasta que termina
• get_generation — lee el estado y las URL de los archivos terminados sin esperar
• list_models — descubre los modelos activos, sus capacidades y sus precios en créditos
• get_model — consulta el esquema de entrada y el precio de un modelo
• get_balance — lee el saldo de créditos de la cuenta conectada y el uso reciente
• search_templates — busca prompts de imagen y vídeo listos para usar

5 herramientas que dependen de las capacidades

• chat — llama a un modelo de texto
• generate_scenario — convierte un briefing de vídeo en escenas y prompts estructurados
• compose_video — combina escenas generadas, narración, música y subtítulos
• generate_presentation — crea un PPTX editable, un PDF y vistas previas de las diapositivas
• edit_presentation — revisa una presentación existente reutilizando las ilustraciones que no cambian

Siete herramientas auxiliares exclusivas de la aplicación controlan las tarjetas en vivo de resultados, de repetición y de composición. Quedan fuera del contexto del modelo y no amplían la lista de herramientas del agente de IA. Consulte Herramientas MCP para ver los parámetros y los detalles de disponibilidad.

Prompts listos para usar

Además de las herramientas, el servidor ofrece cuatro flujos de trabajo listos para usar a través de prompts/list. Claude Code los muestra como comandos de barra; otros clientes los enumeran en su menú de prompts. Un prompt inserta en la conversación instrucciones paso a paso para el agente; las generaciones en sí se ejecutan con las herramientas habituales y se pagan en créditos.

Flujo de vídeo de principio a fin

Un agente puede completar un vídeo entero en lugar de detenerse en un único clip generado:

1. Llame a generate_scenario para dividir un briefing en escenas cuando la planificación de guiones esté activada.
2. Llame a generate_video para cada escena. Pase image_url cuando un fotograma inicial o una referencia visual deba guiar la toma.
3. Llame a generate_audio para la narración y a generate_music para la banda sonora cuando sea necesario.
4. Llame a compose_video para montar de 2 a 20 escenas terminadas, con locución, música y subtítulos opcionales.
5. Llame a wait_generation hasta que la tarea final esté en COMPLETED y, a continuación, devuelva output.video.url.

Para un único clip, empiece con generate_video y consulte periódicamente el request_id devuelto; las herramientas de planificación y composición son opcionales.

Obtener una clave

Cree una clave de API en la Consola de desarrollador. Las claves con el prefijo clipia_live_ son de producción (consumen créditos); las claves con el prefijo clipia_test_ funcionan en el sandbox: resultados de prueba instantáneos sin cargo, útiles para depurar agentes y CI.

Conectar un cliente

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer $CLIPIA_KEY"

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${CLIPIA_KEY}" }
    }
  }
}

{
  "servers": {
    "clipia": {
      "type": "http",
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${CLIPIA_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "clipia": {
      "serverUrl": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${CLIPIA_KEY}" }
    }
  }
}

Tareas, coste y reintentos seguros

Las llamadas de imagen suelen terminar en una sola petición. Las tareas de vídeo, audio, música, composición y presentaciones son asíncronas:

1. La herramienta de generación devuelve un request_id, el estado actual y el coste en créditos.
2. Llame a wait_generation repetidamente hasta que el estado sea COMPLETED, FAILED o CANCELED.
3. Al terminar, lea las URL del contenido multimedia o de los documentos en output.

Utilice un idempotency_key estable solo cuando reintente la misma petición de pago sin cambios tras un fallo de transporte o un fallo de resultado incierto. Utilice una clave nueva después de cambiar el prompt, los archivos o los ajustes. Así se evita que un bucle del agente cobre dos veces la misma operación.

Sandbox

Las claves con el prefijo clipia_test_ devuelven resultados de prueba instantáneos sin cargo, útiles para depurar el análisis de respuestas, el polling y los pipelines. Las claves de producción devuelven el coste exacto de cada generación, y la herramienta get_balance informa del saldo de créditos restante.

Descubrimiento legible por máquinas

Los agentes y los rastreadores pueden descubrir el mismo contrato sin analizar el sitio comercial:

• Datos del producto para LLM e inventario de herramientas
• Índice de la documentación para desarrolladores
• Tarjeta del servidor MCP
• Índice de habilidades para agentes
• Especificación OpenAPI 3.1
• Guía de autenticación

La tarjeta del servidor se genera a partir de la configuración actual, por lo que su lista de herramientas es la mejor fuente para saber qué puede invocar un agente en ese momento. Consulte la referencia completa de herramientas MCP o la descripción general de la API REST.