LogoAI Music API
Se connecter
APIJournal des modifications (2/9)

Mises à jour développeurs

Journal des modifications de l'API

Suivez les fonctionnalités API publiées, les notes de compatibilité et les actions requises pour votre intégration.

Dernière mise à jour

5 nov. 2026

Historique des versions

7 mises à jour
  1. Ajout
    RétrocompatiblePOST /v2/replace-sectionAll models

    Nouveau : le remplacement de section régénère une partie d'une chanson

    POST /v2/replace-section régénère une fenêtre temporelle d'une chanson créée avec /v2/generate ou /v2/extend et renvoie la chanson complète avec cette partie refaite.

    Modifications

    • La fenêtre doit durer au moins 10 secondes, au plus 50 % de la chanson et 480 secondes, et se terminer avant la fin de la chanson. Les fenêtres non valides sont rejetées avant tout débit de crédits.
    • Environ 10 secondes de chaque côté de la fenêtre sont aussi recalculées pour que la nouvelle partie s'enchaîne ; le reste de la chanson ne change pas.
    • Si lyrics est omis, les paroles chantées dans la fenêtre sont renseignées automatiquement.
    • Les résultats dont la durée diffère de l'original de plus de 15 secondes sont écartés. S'il n'en reste aucun, la tâche est FAILED et remboursée.
    • 5 crédits par requête ; les requêtes rejetées et les tâches échouées sont remboursées automatiquement.

    Impact sur l'intégration

    Aucune modification n'est nécessaire pour les intégrations existantes. Envoyez origin_task_id, audio_id, infill_start_s, infill_end_s et prompt pour l'utiliser.

    Voir la documentation de l'endpoint
  2. Modification
    RétrocompatiblePOST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models

    Les requêtes rejetées renvoient 422 ou 500 et sont remboursées immédiatement

    Les endpoints de création signalent désormais les rejets de validation de façon synchrone et remboursent les crédits, au lieu de renvoyer 200 avec une tâche qui ne se termine jamais.

    Modifications

    • 422 signifie qu'un paramètre a été rejeté lors de la validation ; le message nomme le champ à corriger (par exemple title ou extensionStartTime).
    • 500 signifie une défaillance temporaire ; réessayez plus tard.
    • Les deux réponses incluent data.task_id, data.refunded et workId, et la tâche est marquée FAILED.
    • Les tâches qui échouent après acceptation, y compris les extensions, sont marquées FAILED avec un fail_message et leurs crédits sont remboursés automatiquement.
    • Auparavant, ces requêtes renvoyaient 200 et la tâche restait IN_PROGRESS indéfiniment.

    Impact sur l'intégration

    En cas de 422, corrigez le paramètre indiqué ; en cas de 500, réessayez plus tard. Les deux réponses incluent data.refunded.

    Voir la documentation de l'endpoint
  3. Modification
    RétrocompatiblePOST /v2/extendAll models

    Les requêtes extend normalisent le texte et le temps de départ au lieu d'échouer

    POST /v2/extend tronque désormais le texte Custom Mode trop long et borne extensionStartTime, de sorte que ces champs ne provoquent plus de rejet.

    Modifications

    • title est limité à 80 caractères ; les valeurs plus longues sont tronquées.
    • prompt est limité à 5000 caractères et style à 1000 ; les valeurs plus longues sont tronquées.
    • extensionStartTime est borné à 1 … (durée source - 1) secondes ; les valeurs absentes ou invalides utilisent la fin du morceau source.
    • Les extensions sont facturées au prix du modèle du morceau d'origine et produites par chirp-v6 (morceaux chirp-v5 / chirp-v5-5) ou chirp-v6-mini (morceaux plus anciens).

    Impact sur l'intégration

    Cette mise à jour est rétrocompatible. Gardez title sous 80 caractères pour éviter la troncature.

    Voir la documentation de l'endpoint
  4. Modification
    RétrocompatiblePOST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5

    Les identifiants hérités chirp-v3-5 à chirp-v5-5 sont servis par la famille chirp-v6

    Les requêtes qui envoient encore un identifiant de modèle retiré continuent de fonctionner et conservent leur prix historique.

    Modifications

    • chirp-v5 et chirp-v5-5 (12 crédits) sont servis par chirp-v6.
    • chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus et chirp-v4-5-all sont servis par chirp-v6-mini.
    • Chaque identifiant hérité reste facturé à son prix historique (5, 8, 10 ou 12 crédits).
    • model_name dans les résultats status, feed et callback indique désormais toujours le modèle public ayant produit l'audio, par exemple chirp-v6-mini.
    • Si le champ model est omis, la requête est facturée au palier de base de 5 crédits et servie par chirp-v6-mini.

    Impact sur l'intégration

    Aucun changement requis. Mettez à jour le champ model vers chirp-v6 ou chirp-v6-mini quand cela vous convient.

    Voir la documentation de l'endpoint
  5. Ajout
    RétrocompatiblePOST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild

    Modèles chirp-v6, chirp-v6-mini et chirp-v6-wild

    La gamme actuelle est désormais la famille chirp-v6, disponible pour generate, upload-cover et extend.

    Modifications

    • chirp-v6 est le modèle phare, chirp-v6-mini le palier rapide et économique, chirp-v6-wild la variante plus expérimentale.
    • chirp-v6 et chirp-v6-wild coûtent 12 crédits par requête, chirp-v6-mini 10.
    • Les limites de texte sont identiques pour tous les modèles : prompt personnalisé 5000, prompt inspiration 3000, style 1000, title 80 (100 pour upload-cover). Les entrées trop longues sont tronquées, pas rejetées.
    • Les extensions d'un morceau chirp-v6 utilisent le même modèle ; le champ duration est transmis pour les requêtes generate en Custom Mode.

    Impact sur l'intégration

    Cette mise à jour est rétrocompatible. Basculez les nouvelles intégrations vers chirp-v6-mini ou chirp-v6.

    Voir la documentation de l'endpoint
  6. Ajout
    RétrocompatiblePOST /v2/generate · /v2/upload-cover/generatechirp-v6 family

    Image to Music avec image_urls

    POST /v2/generate et POST /v2/upload-cover/generate acceptent désormais des images de référence qui façonnent l'ambiance du morceau.

    Modifications

    • Envoyez image_urls sous forme de tableau de 5 URL d'images publiquement accessibles au maximum.
    • JPEG, JPG, PNG et WEBP sont pris en charge, jusqu'à 10 Mo par image.
    • Les images s'appliquent uniquement au mode Inspiration (generate) et au mode non personnalisé (upload-cover) ; elles sont ignorées silencieusement en Custom Mode.
    • L'entrée d'images ajoute 1 crédit par requête au prix du modèle.
    • Le prompt texte est facultatif lorsque des images sont fournies ; combinez les deux pour guider le résultat.

    Impact sur l'intégration

    Cette mise à jour est rétrocompatible. N'ajoutez image_urls que si les images doivent influencer le résultat.

    Voir la documentation de l'endpoint
  7. Ajout
    RétrocompatiblePOST /v2/generatechirp-v5-5

    Durée personnalisée pour chirp-v5-5

    Les requêtes en mode personnalisé utilisant chirp-v5-5 peuvent désormais définir une durée cible pour le morceau.

    Modifications

    • Le champ duration est disponible uniquement pour chirp-v5-5 en mode personnalisé.
    • Envoyez une valeur comprise entre 10 et 360 secondes.
    • Une valeur absente ou non valide utilise 20 secondes.
    • Les autres modèles et le mode Inspiration ignorent ce champ.

    Impact sur l'intégration

    Cette mise à jour est rétrocompatible. Les requêtes existantes continuent de fonctionner sans modification.

    Voir la documentation de l'endpoint