---
title: Use Clipia con agentes de IA
description: Ofrezca a los agentes de IA herramientas de vídeo, imagen, voz, música y presentaciones mediante Clipia MCP, o automatice la generación de imágenes y vídeos con la API REST.
icon: Plug
---

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.

<Callout type="info" title="Endpoint">
Dirección del servidor (Streamable HTTP): `https://mcp.clipia.ai/mcp`. Inicie sesión con una clave de API de Clipia o con su cuenta de Clipia mediante OAuth. La clave puede enviarse como `Authorization: Bearer clipia_...` (recomendado), `Authorization: Key <key>` o `X-Api-Key: <key>`.
</Callout>

## Elija entre MCP y la API REST [#mcp-or-rest]

| Opción | Más adecuada cuando | Qué obtiene |
| --- | --- | --- |
| **Servidor MCP remoto** | Un agente de IA debe descubrir las herramientas y decidir qué paso de generación ejecutar | Streamable HTTP, esquemas de herramientas, autenticación por OAuth o clave de API, tarjetas interactivas de resultados en los clientes compatibles |
| **API REST + SDK** | Su backend, producto o automatización gestiona un flujo de imagen o vídeo | Endpoints de cola de imagen y vídeo, webhooks, OpenAPI y SDK oficiales para TypeScript y Python |

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 [#tools]

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](/es/docs/mcp/tools) para ver los parámetros y los detalles de disponibilidad.

## Prompts listos para usar [#prompts]

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.

| Prompt | Qué hace | Argumentos |
| --- | --- | --- |
| `product_shot` | Convierte una foto de producto en un conjunto para marketplace: varios fondos y un breve vídeo de rotación | `image_url` (obligatorio), `product`, `variants` (4 por defecto) |
| `blog_covers` | Genera portadas coherentes para una lista de titulares de artículos | `titles` (obligatorio, uno por línea), `style`, `aspect_ratio` (`16:9` por defecto) |
| `campaign_storyboard` | Convierte el briefing de una campaña en fotogramas de escenas, anima los aprobados y añade una locución | `brief` (obligatorio), `scenes` (6 por defecto), `voiceover` |
| `animate_photo` | Convierte una foto fija en un clip breve con el movimiento de cámara elegido | `image_url` (obligatorio), `motion`, `duration` (6 segundos por defecto) |

## Flujo de vídeo de principio a fin [#video-workflow]

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 [#key]

Cree una clave de API en la [Consola de desarrollador](/es/developer). 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.

<Callout type="warn" title="La clave es un secreto del lado del servidor">
Una clave de producción se muestra solo una vez, al crearla: es la contraseña de su saldo de créditos. Guárdela en una variable de entorno como `CLIPIA_KEY` o en un gestor de secretos y nunca la suba a un repositorio.
</Callout>

## Conectar un cliente [#connect]

<Callout type="info" title="Tarjetas en el chat">
  En claude.ai el resultado se muestra como una tarjeta interactiva con el progreso en vivo
  y el contenido multimedia. En Claude Code aparece una vista previa en línea en el terminal. Otros clientes
  devuelven enlaces al archivo en calidad completa.
</Callout>

<Tabs items={['Claude Code', 'claude.ai', 'ChatGPT', 'Cursor', 'VS Code', 'Windsurf']}>

<Tab value="Claude Code">

Un solo comando en el terminal y las herramientas de Clipia estarán disponibles en cualquier sesión, incluidas las sesiones headless y CI. Tome la clave de una variable de entorno en lugar de escribirla en el código:

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

Después pídale a Claude: «Genere una imagen de una ciudad de neón en Clipia»; la vista previa aparece directamente en el terminal.

</Tab>

<Tab value="claude.ai">

claude.ai (web, escritorio, móvil) se conecta iniciando sesión en su cuenta de Clipia (OAuth); no se necesita clave:

1. Abra Settings → Connectors.
2. Haga clic en «Add custom connector» y pegue la URL `https://mcp.clipia.ai/mcp`.
3. Haga clic en Connect e inicie sesión en su cuenta de Clipia.
4. En un chat nuevo, pida una imagen o un vídeo: en el mensaje aparece una tarjeta en vivo de Clipia con el progreso y un botón «Original».

</Tab>

<Tab value="ChatGPT">

1. En ChatGPT (web): Settings → Apps & Connectors → Advanced settings → active Developer mode (Plus, Pro, Business, Enterprise).
2. Apps & Connectors → Create. Nombre: Clipia; MCP Server URL: `https://mcp.clipia.ai/mcp`.
3. Authentication: OAuth; marque «I trust this application» y haga clic en Create.
4. Inicie sesión en su cuenta de Clipia. En un chat, haga clic en «+» → More → Clipia y pida generaciones en lenguaje natural.

</Tab>

<Tab value="Cursor">

Añada el servidor a `~/.cursor/mcp.json` (global) o a `.cursor/mcp.json` en el proyecto y reinicie Cursor. Sustituya el marcador por la clave tomada de una variable de entorno:

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

</Tab>

<Tab value="VS Code">

Cree `.vscode/mcp.json` en su espacio de trabajo (o mediante el comando «MCP: Add Server»). Abra Copilot Chat en modo Agent y las herramientas de Clipia aparecerán en la lista:

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

</Tab>

<Tab value="Windsurf">

Añada el servidor a `~/.codeium/windsurf/mcp_config.json` (el campo `serverUrl` es una particularidad de Windsurf) y, a continuación, actualice la lista de servidores en Cascade → MCPs:

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

</Tab>

</Tabs>

## Tareas, coste y reintentos seguros [#jobs]

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 [#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 [#discovery]

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

- [Datos del producto para LLM e inventario de herramientas](https://clipia.ai/llms.txt)
- [Índice de la documentación para desarrolladores](https://clipia.ai/es/docs/llms.txt)
- [Tarjeta del servidor MCP](https://clipia.ai/.well-known/mcp/server-card.json)
- [Índice de habilidades para agentes](https://clipia.ai/.well-known/agent-skills/index.json)
- [Especificación OpenAPI 3.1](https://clipia.ai/openapi/clipia-v1.json)
- [Guía de autenticación](https://clipia.ai/auth.md)

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](/es/docs/mcp/tools) o la [descripción general de la API REST](/es/docs/api-reference).