APIRegistro de cambios (2/9)

Actualizaciones para desarrolladores

Registro de cambios de la API

Consulta las funciones publicadas de la API, las notas de compatibilidad y las acciones necesarias para tu integración.

Actualización más reciente

5 nov 2026

Historial de versiones

7 actualizaciones

5 nov 2026Añadido
Compatible con versiones anterioresPOST /v2/replace-sectionAll models
Nuevo: el reemplazo de sección vuelve a generar una parte de la canción
POST /v2/replace-section vuelve a generar una ventana de tiempo de una canción creada con /v2/generate o /v2/extend y devuelve la canción completa con esa parte rehecha.
Qué cambió
- La ventana debe durar al menos 10 segundos, como máximo el 50% de la canción y 480 segundos, y terminar antes del final de la canción. Las ventanas no válidas se rechazan antes de cobrar créditos.
- Unos 10 segundos a cada lado de la ventana también se vuelven a renderizar para que la nueva parte encaje; el resto de la canción no cambia.
- Si se omite lyrics, la letra que se canta dentro de la ventana se completa automáticamente.
- Los resultados cuya duración difiere de la original en más de 15 segundos se descartan. Si no queda ninguno, la tarea queda como FAILED y se reembolsa.
- 5 créditos por solicitud; las solicitudes rechazadas y las tareas que fallan se reembolsan automáticamente.
Impacto en la integración
Las integraciones existentes no necesitan cambios. Envía origin_task_id, audio_id, infill_start_s, infill_end_s y prompt para empezar a usarlo.
Ver documentación del endpoint
17 sept 2026Modificado
Compatible con versiones anterioresPOST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models
Las solicitudes rechazadas devuelven 422 o 500 y se reembolsan de inmediato
Los endpoints de creación ahora informan los rechazos de validación de forma síncrona y reembolsan los créditos, en lugar de devolver 200 con una tarea que nunca termina.
Qué cambió
- 422 significa que un parámetro fue rechazado durante la validación; el mensaje indica el campo a corregir (por ejemplo title o extensionStartTime).
- 500 significa un fallo temporal; reintenta más tarde.
- Ambas respuestas incluyen data.task_id, data.refunded y workId, y la tarea se marca como FAILED.
- Las tareas que fallan tras ser aceptadas, incluidas las extensiones, se marcan como FAILED con fail_message y sus créditos se reembolsan automáticamente.
- Antes, estas solicitudes devolvían 200 y la tarea permanecía IN_PROGRESS indefinidamente.
Impacto en la integración
Ante un 422 corrige el parámetro indicado; ante un 500 reintenta más tarde. Ambas respuestas incluyen data.refunded.
Ver documentación del endpoint
17 sept 2026Modificado
Compatible con versiones anterioresPOST /v2/extendAll models
Las solicitudes extend normalizan el texto y el tiempo de inicio en lugar de fallar
POST /v2/extend ahora trunca el texto demasiado largo del Custom Mode y acota extensionStartTime, por lo que estos campos ya no provocan rechazos.
Qué cambió
- title está limitado a 80 caracteres; los valores más largos se truncan.
- prompt está limitado a 5000 caracteres y style a 1000; los valores más largos se truncan.
- extensionStartTime se acota a 1 … (duración de origen - 1) segundos; los valores ausentes o inválidos usan el final de la pista original.
- Las extensiones se facturan al precio del modelo de la pista original y las produce chirp-v6 (pistas chirp-v5 / chirp-v5-5) o chirp-v6-mini (pistas heredadas más antiguas).
Impacto en la integración
Esta actualización es retrocompatible. Mantén title en 80 caracteres o menos para evitar el truncamiento.
Ver documentación del endpoint
17 sept 2026Modificado
Compatible con versiones anterioresPOST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5
Los identificadores heredados chirp-v3-5 a chirp-v5-5 son atendidos por la familia chirp-v6
Las solicitudes que aún envían un identificador de modelo retirado siguen funcionando y conservan su precio histórico.
Qué cambió
- chirp-v5 y chirp-v5-5 (12 créditos) son atendidos por chirp-v6.
- chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus y chirp-v4-5-all son atendidos por chirp-v6-mini.
- Cada identificador heredado sigue facturándose a su precio histórico (5, 8, 10 o 12 créditos).
- model_name en los resultados de status, feed y callback ahora siempre indica el modelo público que produjo el audio, por ejemplo chirp-v6-mini.
- Si se omite el campo model, la solicitud se factura al nivel base de 5 créditos y la atiende chirp-v6-mini.
Impacto en la integración
No se requiere ningún cambio. Actualiza el campo model a chirp-v6 o chirp-v6-mini cuando te convenga.
Ver documentación del endpoint
17 sept 2026Añadido
Compatible con versiones anterioresPOST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild
Modelos chirp-v6, chirp-v6-mini y chirp-v6-wild
La gama actual de modelos pasa a ser la familia chirp-v6, disponible en generate, upload-cover y extend.
Qué cambió
- chirp-v6 es el modelo principal, chirp-v6-mini es el nivel rápido y económico, chirp-v6-wild es la variante más experimental.
- chirp-v6 y chirp-v6-wild cuestan 12 créditos por solicitud, chirp-v6-mini cuesta 10.
- Los límites de texto son iguales para todos los modelos: prompt personalizado 5000, prompt de inspiración 3000, style 1000, title 80 (100 en upload-cover). Las entradas largas se truncan en lugar de rechazarse.
- Las extensiones de una pista chirp-v6 usan el mismo modelo; el campo duration se reenvía en solicitudes generate en Custom Mode.
Impacto en la integración
Esta actualización es retrocompatible. Cambia las nuevas integraciones a chirp-v6-mini o chirp-v6.
Ver documentación del endpoint
17 sept 2026Añadido
Compatible con versiones anterioresPOST /v2/generate · /v2/upload-cover/generatechirp-v6 family
Image to Music con image_urls
POST /v2/generate y POST /v2/upload-cover/generate ahora aceptan imágenes de referencia que definen el ambiente de la pista generada.
Qué cambió
- Envía image_urls como un array de hasta 5 URL de imagen accesibles públicamente.
- Se admiten JPEG, JPG, PNG y WEBP, hasta 10MB por imagen.
- Las imágenes solo se aplican en el modo Inspiración (generate) y en el modo no personalizado (upload-cover); en Custom Mode se ignoran silenciosamente.
- La entrada de imágenes añade 1 crédito por solicitud al precio del modelo.
- El prompt de texto es opcional cuando hay imágenes; combina ambos para guiar el resultado.
Impacto en la integración
Esta actualización es retrocompatible. Añade image_urls solo cuando quieras que las imágenes influyan en el resultado.
Ver documentación del endpoint
25 jul 2026Añadido
Compatible con versiones anterioresPOST /v2/generatechirp-v5-5
Duración personalizada para chirp-v5-5
Las solicitudes en modo personalizado con chirp-v5-5 ahora pueden definir la duración objetivo de la pista.
Qué cambió
- El campo duration solo está disponible para chirp-v5-5 en modo personalizado.
- Envía un número entre 10 y 360 segundos.
- Los valores ausentes o no válidos usan 20 segundos.
- Los demás modelos y el modo Inspiración ignoran este campo.
Impacto en la integración
Esta actualización es compatible con versiones anteriores. Las solicitudes existentes siguen funcionando sin cambios.
Ver documentación del endpoint

Historial de versiones

Nuevo: el reemplazo de sección vuelve a generar una parte de la canción

Qué cambió

Las solicitudes rechazadas devuelven 422 o 500 y se reembolsan de inmediato

Qué cambió

Las solicitudes extend normalizan el texto y el tiempo de inicio en lugar de fallar

Qué cambió

Los identificadores heredados chirp-v3-5 a chirp-v5-5 son atendidos por la familia chirp-v6

Qué cambió

Modelos chirp-v6, chirp-v6-mini y chirp-v6-wild

Qué cambió

Image to Music con image_urls

Qué cambió

Duración personalizada para chirp-v5-5

Qué cambió