--- title: Registro de cambios description: 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. icon: History --- Historial de cambios de la API pública de Clipia (`/v1/*`), el servidor MCP remoto `https://mcp.clipia.ai/mcp`, LLM Gateway y los SDK oficiales. Las entradas más recientes aparecen primero. El contrato de `/v1/*` es estable; los cambios incompatibles se indican de forma explícita. Las entradas de julio a septiembre de 2026 se agrupan por meses. ## 2026-10-13 - **Los parámetros ignorados ya no se descartan en silencio.** Si `input` contiene una clave que el modelo no aplicará (una errata, un parámetro de otro modelo), `POST /v1/models/{model}` y `/estimate` aceptan la solicitud como antes, pero devuelven la clave en la matriz [`warnings`](/es/docs/api-reference/submit#warnings). Las solicitudes que funcionaban siguen funcionando. - **MCP rechaza esa llamada antes de iniciarla.** `generate_image`, `generate_video`, `generate_audio` y `generate_music` responden con un error `invalid_request` que nombra los parámetros rechazados y enumera los que el modelo declara; no se crea ninguna generación. También se aplica a los argumentos de nivel superior; por ejemplo, `seed` en un modelo que no lo declara. Consulte [Herramientas MCP](/es/docs/mcp/tools#unsupported-parameters). - **SDK 1.5.0.** TypeScript `clipia-ai` y Python `clipia` 1.5.0 describen `warnings` en las respuestas de envío y de estimación del coste; consulte los ejemplos en las páginas [SDK de TypeScript](/es/docs/sdk/typescript#warnings) y [SDK de Python](/es/docs/sdk/python#warnings). - **Seedance 2.x: el audio está activado si se omite el parámetro.** Una solicitud a Seedance 2, 2 Fast, 2 Mini o 2.5 sin `generate_audio` devuelve ahora un vídeo con audio, tal como declara el `input_schema` del modelo (`default: true`). Antes, una solicitud así enviada por la API o por MCP se generaba sin audio. Para obtener un vídeo sin audio, envíe `generate_audio: false`. Si la pista de audio no supera las normas de seguridad, el vídeo puede llegar sin audio. El coste de la solicitud no ha cambiado. Consulte la [página de Seedance 2.5](/es/docs/api-reference/models/seedance-2-5). - **El audio descartado se comunica en la API y en MCP.** Si la pista de audio de un vídeo no supera la comprobación de seguridad del modelo, el servidor repite la generación sin sonido. Ahora lo comunica un array `warnings` con el código `audio_dropped`: en `GET /v1/requests/{id}` y `GET /v1/requests/{id}/status`, y en MCP en las respuestas de `wait_generation` y `get_generation`. El coste de la solicitud no cambia. Consulte [Resultado de la generación](/es/docs/api-reference/result). - **El interruptor de audio de los modelos de vídeo se lee igual en todas partes.** `true`, `1`, `"yes"` y `"on"` activan el audio; `false`, `0`, `"no"` y `"off"` lo desactivan, de forma idéntica para el coste y para la ejecución. Una cadena que no se pueda leer como interruptor cuenta como parámetro omitido: se aplica el valor por defecto del modelo. Antes, las cadenas `"1"`, `"yes"` y `"on"` desactivaban el audio en algunos modelos. - **Kling 3 Multi-Shot: audio con dos o más escenas.** El modelo siempre genera ese vídeo con audio. Una solicitud con `sound: false` se acepta como antes, el coste se calcula con audio y la respuesta incluye un aviso `unsupported_parameter`. - **Vídeos de referencia de Seedance 2.x: límite de clips.** Seedance 2, 2 Fast y 2 Mini aceptan hasta 3 vídeos de referencia, Seedance 2.5 hasta 10; el límite se declara en el `input_schema` del modelo (`maxItems`). Una solicitud por encima del límite se rechaza con `400` antes de reservar créditos. Antes, los clips sobrantes se descartaban en silencio. - **`list_models` de MCP devuelve el catálogo por páginas.** La respuesta incluye `total`, `truncated` y `next_offset`; la página siguiente se pide con `offset`. Antes, un catálogo largo se cortaba sin aviso. Consulte [Herramientas de MCP](/es/docs/mcp/tools#core). - **Un fallo del cálculo del coste responde `503` en lugar de un precio inexacto.** Si el servidor no puede leer temporalmente los parámetros de precio de un modelo, el envío y `/estimate` responden `503`: reintente en breve, no se reservan créditos. En el catálogo ese modelo puede incluir `pricing: { available: false }`. ## 2026-10-09 - **Documentación: secciones de producto, estudios y modelos; nuevo diseño del portal.** El portal describe ahora el propio producto, los estudios y los modelos, y las páginas de la API, MCP y los SDK se han contrastado con el funcionamiento actual del servicio. - **Slugs con barra a través de REST.** Los modelos como `google/imagen4` ya pueden llamarse mediante `POST /v1/models/{family}/{model}`, no solo a través de MCP; consulte el [catálogo](/es/docs/api-reference/models#mcp-only). Las respuestas de `/v1/chat/completions` pueden consultarse con `GET /v1/generation?id=chatcmpl-…`; los errores de generación comparten un único diccionario `error.code`; cada `429` incluye `Retry-After`. - **Nueva guía.** [Migrar desde otra API de generación](/es/docs/guides/migration) explica cómo trasladar una integración a la cola de Clipia. ## 2026-09 [#2026-09] - **SDK 1.2.0.** TypeScript `clipia-ai` y Python `clipia` 1.2.0 describen el campo `text_limits` de los modelos de texto a voz: la longitud mínima y máxima del texto. - **La longitud del texto de voz se comprueba de antemano.** La API REST y MCP rechazan con `400` el texto fuera de `text_limits` antes de crear una generación, por lo que no se reservan créditos. Los límites se muestran en `GET /v1/models/{model}` y en `get_model`. ## 2026-08 [#2026-08] - **Seedance 2.5.** Se han añadido al catálogo `seedance-2-5-t2v` y `seedance-2-5-i2v` de ByteDance; consulte la [página del modelo](/es/docs/api-reference/models/seedance-2-5). - **Vista previa de fotograma en MCP.** `generate_video` devuelve una vista previa integrada de un fotograma para que el agente pueda ver el resultado. ## 2026-07 [#2026-07] - **LLM Gateway.** Un `POST /v1/chat/completions` compatible con OpenAI con streaming, llamadas a herramientas y salidas estructuradas; los modelos de texto se han incorporado al catálogo común `GET /v1/models`. Consulte [LLM Gateway](/es/docs/llm-gateway). - **SDK 1.1.0.** `models.list()` y `models.get()` en ambos SDK admiten los modelos de texto del catálogo. - **Nuevas herramientas MCP.** `generate_audio` (texto a voz), `generate_music`, `chat`, `generate_scenario` y `compose_video` (montaje de escenas en un vídeo final), `generate_presentation` y `edit_presentation`. La lista y los parámetros están en la página [Herramientas MCP](/es/docs/mcp/tools). - **Prompts MCP listos para usar.** El servidor ofrece los prompts `product_shot`, `blog_covers`, `campaign_storyboard` y `animate_photo`; consulte [Prompts listos para usar](/es/docs/mcp#prompts). - **Contenido multimedia en el chat.** En los clientes compatibles con MCP Apps, los resultados se muestran como una tarjeta interactiva. ## 2026-06-22 - **Dirección canónica de MCP.** El servidor MCP remoto se ha trasladado a `https://mcp.clipia.ai/mcp`. La antigua dirección `https://api.clipia.ai/mcp` se mantiene como alias heredado por compatibilidad, pero las nuevas integraciones deben usar el endpoint canónico. ## 2026-06-13 - **Vistas previas de imágenes en MCP.** La herramienta `generate_image` devuelve su resultado en una sola llamada con una vista previa integrada: el agente ve la imagen y puede iterar. En claude.ai, las generaciones se muestran como una tarjeta interactiva con el progreso en directo y un botón «Original». - **Los límites de MCP ya no frenan las sesiones.** El ruido de protocolo JSON-RPC (initialize, tools/list, ping) ya no se cuenta para el límite por minuto: solo cuentan las llamadas a herramientas. ## 2026-06-12 - **Lanzamiento de la API pública y de MCP.** La Queue API pública `/v1/*` (submit → poll / webhook) ya está disponible, junto con los SDK oficiales para TypeScript (`clipia-ai`) y Python (`clipia`) y una CLI. - **Servidor MCP remoto.** La dirección original `https://api.clipia.ai/mcp` (ahora un alias heredado) se lanzó con 8 herramientas para agentes y un asistente aparte solo para la app: genere imágenes y vídeo directamente desde Claude Code, claude.ai, ChatGPT, Cursor y otros clientes MCP. - **Sandbox.** Las claves con el prefijo `clipia_test_` devuelven al instante resultados predefinidos sin cargo de créditos. El endpoint de cancelación se ha eliminado de la API pública. Los créditos se reservan en `submit` y la mayoría de los modelos no pueden detener una generación una vez iniciada: `cancel` generaría un estado «CANCELED» engañoso cuando los créditos ya se habrían gastado. El estado `CANCELED` sigue siendo válido en las respuestas: una tarea puede cancelarse fuera de la API y entonces se devuelve como terminal.