Registro de cambios

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. 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.
• 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 y SDK de Python.
• 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.
• 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.
• 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.
• 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. 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 explica cómo trasladar una integración a la cola de Clipia.

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

• 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.
• 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

• 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.
• 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.
• Prompts MCP listos para usar. El servidor ofrece los prompts product_shot, blog_covers, campaign_storyboard y animate_photo; consulte Prompts listos para usar.
• 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.