LogoAI Music API
Iniciar sesión

Endpoints de la API

Registro de cambios

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

17 sept 2026

Historial de versiones

6 actualizaciones
  1. Modificado
    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
  2. Modificado
    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
  3. Modificado
    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
  4. Añ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
  5. Añ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
  6. Añ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