LogoAI Music API
Anmelden
APIÄnderungsprotokoll (2/9)

Updates für Entwickler

API-Änderungsprotokoll

Verfolgen Sie veröffentlichte API-Funktionen, Kompatibilitätshinweise und notwendige Anpassungen Ihrer Integration.

Letztes Update

5. Nov. 2026

Versionsverlauf

7 Updates
  1. Hinzugefügt
    AbwärtskompatibelPOST /v2/replace-sectionAll models

    Neu: Replace Section erzeugt einen Teil eines Songs neu

    POST /v2/replace-section erzeugt ein Zeitfenster eines mit /v2/generate oder /v2/extend erstellten Songs neu und gibt den kompletten Song mit dem neu gerenderten Teil zurück.

    Was sich geändert hat

    • Das Fenster muss mindestens 10 Sekunden lang sein, höchstens 50% des Songs und 480 Sekunden umfassen und vor dem Songende enden. Ungültige Fenster werden abgelehnt, bevor Credits abgebucht werden.
    • Etwa 10 Sekunden auf jeder Seite des Fensters werden ebenfalls neu gerendert, damit der neue Teil nahtlos übergeht; der Rest des Songs bleibt gleich.
    • Wenn lyrics fehlt, wird der im Fenster gesungene Text automatisch eingesetzt.
    • Ergebnisse, deren Länge um mehr als 15 Sekunden vom Original abweicht, werden verworfen. Bleibt keines übrig, ist die Aufgabe FAILED und wird erstattet.
    • 5 Credits pro Anfrage; abgelehnte Anfragen und fehlgeschlagene Aufgaben werden automatisch erstattet.

    Auswirkung auf die Integration

    Bestehende Integrationen müssen nicht geändert werden. Senden Sie origin_task_id, audio_id, infill_start_s, infill_end_s und prompt, um es zu nutzen.

    Endpunkt-Dokumentation öffnen
  2. Geändert
    AbwärtskompatibelPOST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models

    Abgelehnte Anfragen liefern 422 oder 500 und werden sofort erstattet

    Die Erstellungs-Endpunkte melden Validierungsablehnungen jetzt synchron und erstatten die Credits, statt 200 mit einer nie abgeschlossenen Aufgabe zurückzugeben.

    Was sich geändert hat

    • 422 bedeutet, dass ein Parameter bei der Validierung abgelehnt wurde; die Nachricht nennt das zu korrigierende Feld (z. B. title oder extensionStartTime).
    • 500 bedeutet einen vorübergehenden Fehler; später erneut versuchen.
    • Beide Antworten enthalten data.task_id, data.refunded und workId; die Aufgabe wird als FAILED markiert.
    • Aufgaben, die nach Annahme scheitern, einschließlich Erweiterungen, werden mit fail_message als FAILED markiert und automatisch erstattet.
    • Zuvor lieferten solche Anfragen 200 und die Aufgabe blieb dauerhaft IN_PROGRESS.

    Auswirkung auf die Integration

    Bei 422 den genannten Parameter korrigieren, bei 500 später erneut versuchen. Beide Antworten enthalten data.refunded.

    Endpunkt-Dokumentation öffnen
  3. Geändert
    AbwärtskompatibelPOST /v2/extendAll models

    Extend-Anfragen normalisieren Text und Startzeit statt zu scheitern

    POST /v2/extend kürzt jetzt zu langen Custom-Mode-Text und begrenzt extensionStartTime, sodass Anfragen wegen dieser Felder nicht mehr abgelehnt werden.

    Was sich geändert hat

    • title ist auf 80 Zeichen begrenzt; längere Werte werden gekürzt.
    • prompt ist auf 5000 Zeichen und style auf 1000 begrenzt; längere Werte werden gekürzt.
    • extensionStartTime wird auf 1 … (Quelldauer - 1) Sekunden begrenzt; fehlende oder ungültige Werte nutzen das Ende des Quelltracks.
    • Erweiterungen werden zum Modellpreis des Originaltracks abgerechnet und von chirp-v6 (chirp-v5 / chirp-v5-5-Tracks) oder chirp-v6-mini (ältere Tracks) erzeugt.

    Auswirkung auf die Integration

    Dieses Update ist rückwärtskompatibel. Halten Sie title unter 80 Zeichen, um Kürzungen zu vermeiden.

    Endpunkt-Dokumentation öffnen
  4. Geändert
    AbwärtskompatibelPOST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5

    Alte Kennungen chirp-v3-5 bis chirp-v5-5 werden von der chirp-v6-Familie bedient

    Anfragen mit einer eingestellten Modellkennung funktionieren weiterhin und behalten ihren bisherigen Preis.

    Was sich geändert hat

    • chirp-v5 und chirp-v5-5 (12 Credits) werden von chirp-v6 bedient.
    • chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus und chirp-v4-5-all werden von chirp-v6-mini bedient.
    • Jede alte Kennung wird weiterhin zum bisherigen Preis abgerechnet (5, 8, 10 oder 12 Credits).
    • model_name in Status-, Feed- und Callback-Ergebnissen nennt jetzt immer das öffentliche Modell, das das Audio erzeugt hat, z. B. chirp-v6-mini.
    • Fehlt das Feld model, wird die Anfrage mit der Basisstufe von 5 Credits abgerechnet und von chirp-v6-mini bedient.

    Auswirkung auf die Integration

    Keine Änderung nötig. Aktualisieren Sie das Feld model bei Gelegenheit auf chirp-v6 oder chirp-v6-mini.

    Endpunkt-Dokumentation öffnen
  5. Hinzugefügt
    AbwärtskompatibelPOST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild

    Modelle chirp-v6, chirp-v6-mini und chirp-v6-wild

    Die aktuelle Modellreihe ist jetzt die chirp-v6-Familie, verfügbar für generate, upload-cover und extend.

    Was sich geändert hat

    • chirp-v6 ist das Flaggschiff, chirp-v6-mini die schnelle, günstige Stufe, chirp-v6-wild die experimentellere Variante.
    • chirp-v6 und chirp-v6-wild kosten 12 Credits pro Anfrage, chirp-v6-mini 10.
    • Textlimits gelten für alle Modelle gleich: Custom-Prompt 5000, Inspirations-Prompt 3000, style 1000, title 80 (100 bei upload-cover). Längere Eingaben werden gekürzt statt abgelehnt.
    • Erweiterungen eines chirp-v6-Tracks verwenden dasselbe Modell; das Feld duration wird für Custom-Mode-generate-Anfragen weitergegeben.

    Auswirkung auf die Integration

    Dieses Update ist rückwärtskompatibel. Stellen Sie neue Integrationen auf chirp-v6-mini oder chirp-v6 um.

    Endpunkt-Dokumentation öffnen
  6. Hinzugefügt
    AbwärtskompatibelPOST /v2/generate · /v2/upload-cover/generatechirp-v6 family

    Image to Music mit image_urls

    POST /v2/generate und POST /v2/upload-cover/generate akzeptieren jetzt Referenzbilder, die die Stimmung des Tracks prägen.

    Was sich geändert hat

    • Senden Sie image_urls als Array mit bis zu 5 öffentlich erreichbaren Bild-URLs.
    • Unterstützt werden JPEG, JPG, PNG und WEBP mit bis zu 10 MB pro Bild.
    • Bilder gelten nur im Inspirationsmodus (generate) und im Non-Custom-Modus (upload-cover); im Custom Mode werden sie stillschweigend ignoriert.
    • Bildeingaben kosten zusätzlich 1 Credit pro Anfrage zum Modellpreis.
    • Ein Textprompt ist optional, wenn Bilder vorliegen; kombinieren Sie beides zur Steuerung.

    Auswirkung auf die Integration

    Dieses Update ist rückwärtskompatibel. Fügen Sie image_urls nur hinzu, wenn Bilder das Ergebnis beeinflussen sollen.

    Endpunkt-Dokumentation öffnen
  7. Hinzugefügt
    AbwärtskompatibelPOST /v2/generatechirp-v5-5

    Benutzerdefinierte Dauer für chirp-v5-5

    Anfragen im benutzerdefinierten Modus können mit chirp-v5-5 jetzt eine Ziel-Länge für den Track angeben.

    Was sich geändert hat

    • Das Feld duration ist nur für chirp-v5-5 im benutzerdefinierten Modus verfügbar.
    • Senden Sie einen Wert zwischen 10 und 360 Sekunden.
    • Bei fehlenden oder ungültigen Werten werden 20 Sekunden verwendet.
    • Andere Modelle und der Inspirationsmodus ignorieren dieses Feld.

    Auswirkung auf die Integration

    Dieses Update ist abwärtskompatibel. Bestehende Anfragen funktionieren unverändert weiter.

    Endpunkt-Dokumentation öffnen