LogoAI Music API
Anmelden

Modell-Endpunkt · POST /v2/extend

Extend Song API

Setzen Sie eine abgeschlossene Generierung über ihr ursprüngliches Ende fort. Übernehmen Sie die Einstellungen des Quell-Tracks oder steuern Sie die Fortsetzung mit eigenem Prompt, Stil und Titel — alles über einen asynchronen REST-Endpunkt.

Abgerechnet zum Modellpreis des Original-Tracks

Song verlängern ohne neu zu bauen

Die Extend Song API setzt einen bereits generierten Track fort. Verweisen Sie mit origin_task_id auf die abgeschlossene Generierung, wählen Sie mit extend_audio_index eines der zwei zurückgegebenen Audios, und die Plattform komponiert ein neues Segment, das dort ansetzt, wo die Quelle endet.

Zwei Modi decken die üblichen Workflows ab. Der Inherit Mode (custom_mode: false) nutzt die Originalparameter — der schnellste Weg, einen Take zu verlängern. Der Custom Mode (custom_mode: true) akzeptiert neuen Prompt, Stil, Titel und extensionStartTime, um das Arrangement umzulenken — etwa einen energiegeladenen Refrain in ein ruhiges Outro zu verwandeln.

Quickstart: verlängern und pollen

POST /v2/extend mit der Quellaufgabe, dann /v2/feed?workId=... pollen oder callback_url für einen Webhook setzen.

curl
curl -X POST "https://udioapi.pro/api/v2/extend" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv",
    "extend_audio_index": 0,
    "custom_mode": true,
    "prompt": "Change the music style to be calm and lyrical.",
    "style": "lyrical"
  }'

curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"

extensionStartTime ist optional; Werte werden auf 1 … (Quelldauer − 1) Sekunden begrenzt, Standard ist das Ende des Quell-Tracks.

Extend-Anfrageparameter

Verlängerungen werden zum Modellpreis des Original-Tracks abgerechnet. Mit chirp-v5 oder chirp-v5-5 erstellte Tracks werden mit chirp-v6 verlängert, ältere Legacy-Tracks mit chirp-v6-mini.

ParameterTypPflichtHinweise
origin_task_idstringPflichttask_id Ihrer ursprünglichen Generierungsanfrage
extend_audio_indexnumberPflichtWelches zurückgegebene Audio verlängern: 0 oder 1
custom_modebooleanoptionalfalse erbt die Quellparameter (Standard); true aktiviert Custom-Felder
promptstringCustom ModeNeue Lyrics oder Beschreibung, ≤ 5000 Zeichen — wird abgeschnitten
stylestringoptionalStil der Fortsetzung, ≤ 1000 Zeichen — abgeschnitten
titlestringoptionalTitel des verlängerten Tracks, ≤ 80 Zeichen — abgeschnitten
extensionStartTimenumberoptionalStartpunkt in Sekunden; begrenzt auf 1 … (Quelldauer − 1)
callback_urlstringoptionalÖffentlicher HTTPS-Webhook für das Endergebnis

Abgelehnte oder fehlgeschlagene Verlängerungen werden automatisch erstattet — 422-Antworten nennen den zu korrigierenden Parameter, Fehler nach Annahme erscheinen als FAILED im Feed mit erstatteten Credits.

Was Sie bauen können

Verlängerungen kombinieren sich mit dem Rest der Audio-API.

Längere Arrangements

Verketten Sie Verlängerungen für Intros, Strophen und Outros über die Originallänge hinaus.

Doku lesen

Das Ende umlenken

Der Custom Mode lässt neuen Prompt und Stil bestimmen, wohin die Fortsetzung geht.

Doku lesen

Zuerst die Quelle generieren

Erstellen Sie den zu verlängernden Track mit /v2/generate — die chirp-v6-Familie läuft auf beiden Endpunkten.

Doku lesen

Eigenes Audio covern

Lieber mit einem Upload starten? Der upload-cover-Endpunkt deckt diesen Flow ab.

Doku lesen

Lyrics mit Zeitstempeln

Rufen Sie zeilenweise Lyric-Timings des verlängerten Ergebnisses ab.

Doku lesen

Callbacks und Polling

Abschluss per /v2/feed-Polling oder callback_url-Webhook erhalten.

Doku lesen

So funktioniert es

Von abgeschlossener Generierung zum längeren Track in vier Schritten.

  1. 1

    Quell-Track generieren

    Erstellen Sie einen Song mit /v2/generate und warten Sie auf SUCCESS. task_id speichern und Audio-Index wählen.

  2. 2

    Verlängerung senden

    POST an /v2/extend mit origin_task_id, extend_audio_index und optionalen Custom-Feldern.

  3. 3

    Pollen oder Callback empfangen

    GET /v2/feed?workId=... alle 5–10 Sekunden oder callback_url für einen Webhook setzen.

  4. 4

    Audio herunterladen

    Bei SUCCESS enthält der Feed die Audio-URLs der Verlängerung — in eigenem Speicher ablegen.

Zum Original-Modellpreis zahlen

Verlängerungen werden pro Anfrage zum Modellpreis des Original-Tracks abgerechnet — etwa $0.12 für einen chirp-v6-Track und $0.10 für chirp-v6-mini, bei 1 USD = 100 Credits.

Abgelehnte (422) und fehlgeschlagene Verlängerungen werden automatisch erstattet. Pay-as-you-go-Credits verfallen nie.

Limits und Hinweise

  • Sie brauchen eine abgeschlossene Quellaufgabe und müssen extend_audio_index 0 oder 1 wählen — die meisten Generierungen liefern zwei Audios.
  • Verlängerungen erben den Modellpreis der Quelle; chirp-v5/chirp-v5-5-Tracks verlängert chirp-v6, ältere Legacy-Tracks chirp-v6-mini.
  • Zu lange prompt-, style- und title-Werte werden abgeschnitten, nicht abgelehnt.
  • extensionStartTime wird in den gültigen Bereich gezogen statt die Anfrage scheitern zu lassen.
  • Audio-URLs sind temporär — laden Sie Ergebnisse in Ihren eigenen Speicher.

udioapi.pro ist ein unabhängiger Drittanbieterdienst. Er ist weder mit Suno, Udio oder MiniMax verbunden noch wird er von ihnen unterstützt oder betrieben.

Extend Song API FAQ

Antworten zu Modi, Abrechnung und dem asynchronen Ablauf.

Was macht die Extend Song API?

Sie setzt eine abgeschlossene Generierung über ihr Ende hinaus fort. Der Inherit Mode nutzt die Quellparameter; der Custom Mode akzeptiert neuen Prompt, Stil, Titel und extensionStartTime.

Wie wird eine Verlängerung abgerechnet?

Pro Anfrage zum Modellpreis des Original-Tracks. Ein chirp-v6-Track kostet zum Verlängern dieselben 12 Credits, chirp-v6-mini kostet 10. Abgelehnte und fehlgeschlagene Verlängerungen werden automatisch erstattet.

Welches Audio verlängere ich?

extend_audio_index 0 für das erste zurückgegebene Audio, 1 für das zweite — die meisten Generierungen liefern zwei Varianten.

Inherit oder Custom Mode?

Inherit Mode (custom_mode: false) setzt mit den Originalparametern fort. Custom Mode (custom_mode: true) lässt neuen Prompt, Stil und Titel die Fortsetzung steuern.

Was, wenn extensionStartTime außerhalb liegt?

Der Wert wird auf 1 … (Quelldauer − 1) Sekunden begrenzt statt zu scheitern; fehlende oder ungültige Werte verlängern ab dem Ende des Quell-Tracks.

Kosten fehlgeschlagene Verlängerungen Credits?

Nein. Bei der Validierung abgelehnte Anfragen liefern 422; nach Annahme fehlgeschlagene Aufgaben erscheinen als FAILED im Feed — Credits werden in beiden Fällen erstattet.

Weiterlesen