# Documentación de Clipia para desarrolladores

> Use Clipia con agentes de IA mediante las herramientas remotas de generación multimedia de MCP, o automatice flujos de trabajo de imagen y vídeo con la API REST y los SDK.

Guía principal para agentes: https://clipia.ai/es/docs/mcp

## Pages

- [Cuenta y saldo](https://clipia.ai/es/docs/api-reference/account): GET /v1/account — el saldo disponible de la cuenta en créditos, además del número de solicitudes y los créditos gastados por esta clave en los últimos 30 días.
- [Errores](https://clipia.ai/es/docs/api-reference/errors): El formato único de errores de la API de Clipia — campos type, code y message, la tabla de estados HTTP y códigos, qué reintentar y cómo leer message.
- [Estimación del coste](https://clipia.ai/es/docs/api-reference/estimate): POST /v1/models/{model}/estimate — averigüe cuánto cuesta una generación en créditos antes de ejecutarla; no se crea ningún trabajo ni se reservan créditos.
- [Idempotencia](https://clipia.ai/es/docs/api-reference/idempotency): La cabecera Idempotency-Key hace que reintentar el envío de una generación sea seguro — la misma solicitud devuelve el mismo request_id sin un segundo trabajo ni un segundo cargo.
- [Descripción general](https://clipia.ai/es/docs/api-reference): La referencia interactiva de la API REST de Clipia — parámetros, esquemas de respuesta, códigos de error y envío de una solicitud de prueba directamente desde la página de la documentación.
- [Gestión de claves](https://clipia.ai/es/docs/api-reference/keys): Cómo crear y revocar una clave de API en la Developer Console, qué incluye una clave nueva, dónde encontrar su secreto de webhook y cuántas claves puede tener.
- [Catálogo de modelos](https://clipia.ai/es/docs/api-reference/models): GET /v1/models — los modelos de imagen, vídeo y audio de Clipia con slugs exactos, esquema de entrada y precios, incluidos los slugs que contienen una barra.
- [API de Seedance 2.5: slugs, parámetros y precios](https://clipia.ai/es/docs/api-reference/models/seedance-2-5): Seedance 2.5 en la API de Clipia — slugs T2V e I2V, límites de los parámetros, cómo comprobar la disponibilidad en el catálogo, estimar el precio y enviar por REST.
- [Cola de generación](https://clipia.ai/es/docs/api-reference/overview): Cómo funciona la cola asíncrona de la API REST de Clipia — envío de un trabajo, consulta del estado, obtención de resultados y webhooks para la generación de imágenes, vídeo y audio.
- [Límites de solicitudes](https://clipia.ai/es/docs/api-reference/rate-limits): Límites de solicitudes de la API de Clipia — 120 solicitudes por minuto por clave y 600 por cuenta, cabeceras RateLimit-*, la respuesta 429, límites de concurrencia y límites de LLM.
- [Resultado de la generación](https://clipia.ai/es/docs/api-reference/result): GET /v1/requests/{request_id} — obtenga el resultado terminado con enlaces a la imagen, el vídeo o el audio; mientras el trabajo sigue en curso, la API devuelve 202.
- [Estado de la solicitud](https://clipia.ai/es/docs/api-reference/status): GET /v1/requests/{request_id}/status — una consulta ligera del estado y el progreso de una generación por su request_id. No se necesita ningún permiso adicional de la clave.
- [Enviar una generación](https://clipia.ai/es/docs/api-reference/submit): POST /v1/models/{model} — ponga en cola una generación de imagen, vídeo o audio, obtenga un request_id y envíe la solicitud directamente desde esta página.
- [Webhooks](https://clipia.ai/es/docs/api-reference/webhooks): Una notificación POST a su servidor cuando termina una generación — formato del cuerpo, verificación de la firma HMAC-SHA256, plazo de respuesta y calendario de reintentos de entrega.
- [Registro de cambios](https://clipia.ai/es/docs/changelog): Historial de cambios de la API pública v1 de Clipia, el servidor MCP, LLM Gateway y los SDK — lanzamiento, nuevas herramientas y modelos, actualizaciones del contrato y de la documentación.
- [Autenticación](https://clipia.ai/es/docs/getting-started/authentication): Cómo autorizar las solicitudes a la API de Clipia — la clave de API, tres formas de cabecera, claves de producción y de prueba, permisos de la clave y cómo guardarla de forma segura.
- [Inicio rápido](https://clipia.ai/es/docs/getting-started/quickstart): Ejecute su primera generación de imagen con la API de Clipia en cuatro pasos, desde crear una clave hasta obtener el resultado, con ejemplos en cURL, TypeScript y Python.
- [Entorno de pruebas](https://clipia.ai/es/docs/getting-started/sandbox): El entorno de pruebas de la API de Clipia — una clave clipia_test_ ejecuta el ciclo completo de envío, estado, resultado y webhook sin cobrar créditos y devuelve una muestra lista.
- [Buenas prácticas](https://clipia.ai/es/docs/guides/best-practices): Cree una integración fiable con la API de Clipia — reintentos idempotentes, webhooks en lugar de consultas de estado, gestión de errores y de 429, estimación del coste y almacenamiento del request_id.
- [Migración desde otra API de generación](https://clipia.ai/es/docs/guides/migration): Traslade una integración desde otra API de generación a Clipia — el flujo submit, status, result, las claves, los webhooks, los créditos y una lista de comprobación previa al lanzamiento.
- [Trabajar con Clipia](https://clipia.ai/es/docs): Clipia es generación con IA de imágenes, vídeo y audio con más de 60 modelos: estudios en el navegador, un asistente, una API, MCP y SDK.
- [Clave y límites](https://clipia.ai/es/docs/llm-gateway/account): GET /v1/key en Clipia AI Gateway — nombre de la clave, uso en 30 días, saldo disponible y límite de solicitudes, además de las cabeceras de límite de frecuencia y la respuesta 429 para el chat con LLM.
- [Chat Completions](https://clipia.ai/es/docs/llm-gateway/chat-completions): POST /v1/chat/completions — el endpoint de chat compatible con OpenAI de Clipia AI Gateway. Respuestas con streaming y normales, parámetros, roles, herramientas y errores.
- [Clipia AI Gateway](https://clipia.ai/es/docs/llm-gateway): Una única API compatible con OpenAI para Claude, GPT, Gemini, DeepSeek y Grok, que se paga con créditos de Clipia. Obtenga una clave y envíe su primera solicitud en un par de minutos.
- [LangChain](https://clipia.ai/es/docs/llm-gateway/langchain): Conecte Clipia AI Gateway a LangChain mediante ChatOpenAI con el base_url de Clipia — chat, llamadas a herramientas, agentes y salida estructurada sobre Claude, GPT y Gemini.
- [Modelos y precios](https://clipia.ai/es/docs/llm-gateway/models): El catálogo de LLM de Clipia AI Gateway en GET /v1/models y los precios en dólares estadounidenses por 1M de tokens de entrada y de salida — Claude, GPT, Gemini, DeepSeek y Grok.
- [Use Clipia con agentes de IA](https://clipia.ai/es/docs/mcp): 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.
- [Herramientas MCP](https://clipia.ai/es/docs/mcp/tools): Parámetros de las 10 herramientas básicas y las 5 opcionales de Clipia MCP, modelos predeterminados, slugs con barra y las siete auxiliares exclusivas de la aplicación que hay detrás de las tarjetas de resultados.
- [Modelos de audio y voz](https://clipia.ai/es/docs/models/audio): Los modelos de Clipia que ponen voz al texto y crean música, con desarrolladores, idiomas, voces, precios en créditos y consejos para elegir modelo y voz.
- [Modelos de imagen](https://clipia.ai/es/docs/models/image): Todos los modelos de imagen de Clipia con desarrolladores, puntos fuertes, proporciones y resolución, cuántas fotos admiten, modos y precio en créditos. Cómo elegir uno.
- [Cómo elegir un modelo](https://clipia.ai/es/docs/models): Panorama de los modelos de imagen, vídeo y audio de Clipia: desarrolladores, cómo leer los precios en créditos y qué modelo encaja en cada tarea (calidad, texto, sonido).
- [Modelos de vídeo](https://clipia.ai/es/docs/models/video): Fichas de los modelos de vídeo de Clipia (Veo, Kling, Seedance, Wan, HappyHorse, Hailuo, Grok y más): modos, duración, calidad, sonido, precios y recomendaciones por tarea.
- [Cuenta y ajustes](https://clipia.ai/es/docs/product/account): Inicio de sesión con correo, Google o Yandex, su perfil y nombre de usuario, idioma, notificaciones, contraseña y autenticación en dos pasos, privacidad y eliminación de la cuenta.
- [Asistente y agente](https://clipia.ai/es/docs/product/assistant): Agente de Clipia y Chat de Clipia — modelos de OpenAI, Anthropic, Google y otros, un agente con herramientas de generación, archivos adjuntos, memoria, exportación y límites.
- [Créditos y planes](https://clipia.ai/es/docs/product/credits): Qué es un crédito, cómo se calculan y se cobran los precios de las generaciones, qué incluyen los planes Basic, Standard, Pro y Ultima y cómo funcionan los paquetes de recarga.
- [Preguntas frecuentes](https://clipia.ai/es/docs/product/faq): Respuestas a las preguntas habituales sobre Clipia, como créditos y planes, reembolsos, pagos, calidad de los resultados, moderación, su cuenta, estudios y la API.
- [Visión general de Clipia](https://clipia.ai/es/docs/product): Qué es Clipia, para quién es y dónde está cada cosa en la aplicación — tendencias y estudios, agente, generación de imágenes, vídeo y audio, su biblioteca, planes y Telegram.
- [Mis trabajos](https://clipia.ai/es/docs/product/my-works): Dónde guarda Clipia sus generaciones, cómo buscarlas, descargarlas, organizarlas, reutilizarlas, publicarlas y eliminarlas, y cuánto almacenamiento le da cada plan.
- [Programa de socios](https://clipia.ai/es/docs/product/partners): Cómo hacerse socio de Clipia, obtener su enlace de referido, qué niveles y porcentajes se aplican, cuándo se abona la comisión y cómo retirarla.
- [Pagos y suscripción](https://clipia.ai/es/docs/product/payments): Cómo pagar una suscripción o un paquete de créditos con tarjeta, en qué moneda se le cobra y cómo funcionan la renovación automática, la cancelación y los reembolsos.
- [Empezar](https://clipia.ai/es/docs/product/quickstart): Regístrese en Clipia, reciba 5 créditos de bienvenida, cree su primera imagen y su primer vídeo en unos minutos, encuentre los resultados y vea cómo continuar.
- [Normas de contenido y derechos de uso](https://clipia.ai/es/docs/product/rules): Qué no puede generar con Clipia, cómo funciona la moderación y qué ocurre con sus créditos si se rechaza una solicitud, y qué derechos de uso concede cada plan.
- [Tendencias y estudios](https://clipia.ai/es/docs/product/studio): Dónde buscar ideas en Clipia y dónde crear — la página Tendencias con la selección de X, las plantillas y sus trabajos, el envío de un trabajo a un estudio con el botón Usar y los tres estudios de imagen, vídeo y sonido.
- [Clipia en Telegram](https://clipia.ai/es/docs/product/telegram): El bot @clipiabot y la miniaplicación de Clipia en Telegram, cómo abrirla, iniciar sesión, obtener los créditos de bienvenida, consultar y recargar el saldo y encontrar sus últimos trabajos.
- [Plantillas](https://clipia.ai/es/docs/product/templates): Cómo encontrar una plantilla lista en la página Tendencias de Clipia — la selección de X y todas las plantillas, búsqueda, categorías y filtros, envío de una plantilla a un estudio con el botón Usar y sus propios trabajos como plantillas.
- [SDK de Python](https://clipia.ai/es/docs/sdk/python): El SDK oficial de Clipia para Python (PyPI clipia 1.5.0): clientes Clipia y AsyncClipia, cola de generación, catálogo y estimaciones de precio, verificación de webhooks y errores.
- [SDK de TypeScript](https://clipia.ai/es/docs/sdk/typescript): El SDK oficial de Clipia para TypeScript (npm clipia-ai 1.5.0): instalación, cola de generación, catálogo y estimaciones de precio, verificación de webhooks, errores y la CLI clipia.
- [Estudio de audio](https://clipia.ai/es/docs/studios/audio): Texto a voz con una sola voz o en diálogo, y música a partir de una descripción — Estudio de audio de Clipia: modelos, ajustes, precios en créditos y consejos.
- [Estudio de carruseles](https://clipia.ai/es/docs/studios/carousel): Carruseles para Instagram y otras redes sociales en Clipia — plan de diapositivas y textos a partir de un tema, formatos, estilos, paletas, diseños, editor, exportación y precios.
- [Mejora y escalado](https://clipia.ai/es/docs/studios/enhance): Cómo aumentar la resolución de fotos y vídeos en Clipia — el modo básico y el modo Topaz, escalado 2× y 4×, límites de archivo y precios en créditos.
- [Estudio de imágenes](https://clipia.ai/es/docs/studios/image): Estudio de imágenes de Clipia — texto a imagen, edición y combinación de fotos, mejora de la calidad y carruseles. Modelos, ajustes, límites y precios en créditos.
- [Introducción a los estudios](https://clipia.ai/es/docs/studios): Qué son los estudios de Clipia, cuál conviene para su tarea y cómo funcionan en todos ellos los modos, el precio en el botón, la reserva de créditos, Mis tareas y Mis trabajos.
- [Tarjetas de producto para marketplaces](https://clipia.ai/es/docs/studios/marketplace): Cómo convertir fotos hechas con el móvil en un conjunto de tarjetas de producto para Wildberries y Ozon — subida, revisión de datos, configuración de las tarjetas, precio y descarga.
- [Vídeo llave en mano](https://clipia.ai/es/docs/studios/video-agent): Un director de IA convierte su idea en un vídeo terminado con guion, locución, música y subtítulos. El guion no consume créditos; el montaje requiere un plan de pago.
- [Estudio de vídeo](https://clipia.ai/es/docs/studios/video): Texto e imagen a vídeo, animación de fotos, fotos parlantes, edición de vídeo, clips a partir de una referencia, mejora de calidad y control de movimiento — modos, modelos, límites y precios.