Seedance 2.5 is live — 30-second cinematic video with native audio & real-person references
Suno V6 API: Versionswahl und Migration Ihrer Integration
2026/09/14

Suno V6 API: Versionswahl und Migration Ihrer Integration

Migrieren Sie Ihre Suno V6 API-Anbindung: V6, Mini und Wild auswählen, snake_case-Felder umstellen, Tasks abfragen und Gebühren pro Aufruf richtig berechnen.

Die Suno V6 API auf reAPI verwendet den bisherigen Audio-Endpunkt mit version: "V6", "V6_MINI" oder "V6_WILD". Prüfen Sie bei einer älteren Integration sowohl die Version als auch die Feldnamen: Die Suno-Schnittstelle verwendet jetzt snake_case. Alte Versionswerte können die Validierung bestehen und trotzdem bei der Generierung scheitern.[1]

Beginnen Sie mit model: "suno-music" und einer ausdrücklich gesetzten V6-Version. Behalten Sie den asynchronen Ablauf aus Übermitteln und Abfragen bei und speichern Sie die Track-Kennungen für spätere Bearbeitungen. Aktualisieren Sie zuerst den Aufbau der Anfrage, dann das Auslesen fertiger Ergebnisse. Den Modellnamen auf suno-v6 zu ändern, ist nicht die dokumentierte Versionsauswahl.

Das Wichtigste

  • Übergeben Sie V6, V6_MINI oder V6_WILD in version; die Modell-ID für neue Songs bleibt suno-music.[1]
  • Ersetzen Sie alte camelCase-Felder durch die dokumentierten snake_case-Namen, etwa custom_mode, negative_tags und audio_id.[1]
  • Verwenden Sie die eingestellten Werte V4–V5.5 nicht mehr. Eine gültige Anfrage bedeutet nicht, dass das Modell noch Audio erzeugt.[1]
  • V6 ist ein Ausgangspunkt für klare musikalische Vorgaben, Mini für die Prüfung kürzerer Wartezeiten und Wild für Experimente. Diese Auswahl beruht auf Sunos Beschreibungen, nicht auf gemessenen Leistungsgarantien.[2]
  • Kalkulieren Sie $0.06 je abgeschlossener Songgenerierung einschließlich zweier Takes. Sound FX kostet separat 13 Credits.[3]

Was sich an Ihrer Suno V6 API-Anfrage ändert

Suno stellte V6 am 9. September 2026 mit drei Varianten und dem Übergang von der vorherigen Modellgeneration vor.[2] Für Entwickler zählt zunächst der Unterschied zwischen einer Produktankündigung und den Feldern, die ihre Integration tatsächlich senden darf.

Die Ankündigung beschreibt umfassendere Funktionen zum Erstellen und Bearbeiten. Dadurch wird nicht jede Funktion der Endkundenanwendung in reAPIs Audio-Anfrage verfügbar. Die aktuelle Song-Anfrage dokumentiert Textsteuerung und die jeweiligen Audioabläufe. Fügen Sie keine Bild- oder Videofelder hinzu, nur weil solche Eingaben in der Ankündigung vorkommen. Maßgeblich ist die vollständige Suno-Parameterreferenz.[1]

Die Suno V6-Referenz zeigt das aktuelle Anfrageformat. model wählt die Operation, version das dafür verwendete Musikmodell. Trennen Sie beide Entscheidungen in Ihrer Anwendung, damit die Wahl von Mini nicht versehentlich von der Songgenerierung zu einer Bearbeitungsoperation wechselt.[4]

Hier geht es um den Zugang über reAPI. Sunos eigenes öffentliches Entwicklerformular beschreibt weiterhin ein Erkundungsprogramm mit ausgewählten Partnern. Es stellt keinen Produktionsschlüssel zur Selbstbedienung aus.[5]

V6, Suno V6 Mini und Suno V6 Wild auswählen

Entscheiden Sie danach, was Sie vom nächsten Ergebnis brauchen. Suno positioniert das Hauptmodell für Präzision, Wild für weniger vorhersehbare Experimente und Mini für schnellere, effizientere Erstellung. Die folgende Einordnung überträgt diese Beschreibungen auf praktische Entscheidungen.[2]

API-WertGeeigneter AusgangspunktWas Sie mit eigenen Aufträgen prüfen sollten
V6Klare Vorgaben zu Genre, Arrangement oder TextOb das Ergebnis der musikalischen Richtung ausreichend folgt
V6_MINIIterationen, bei denen Wartezeit zähltGesamte Wartezeit und ob einer der beiden Takes Ihre Qualitätsanforderung erfüllt
V6_WILDArrangements erkunden, bevor Sie sich festlegenOb die Abweichung nützlich ist oder zusätzliche Bearbeitung verlangt

Mini ist hier keine günstigere API-Stufe. Dieselbe Operation kostet bei allen drei V6-Varianten gleich viel. Ein schnelleres Ergebnis würde also Wartezeit sparen, nicht die angegebene Gebühr dieser Anfrage senken.[4] Für diesen Artikel gab es keinen kontrollierten Latenz- oder Hörvergleich. Behandeln Sie „schneller“ als Sunos Positionierung, bis Sie Ihre eigene Arbeitslast gemessen haben.

Für einen fairen Vergleich bleiben Prompt, Modus und weitere Einstellungen gleich; ändern Sie nur version. Bewerten Sie beide zurückgegebenen Takes. Wenn Sie zugleich Text oder Stil ändern, lässt sich der Unterschied keiner einzelnen Änderung zuordnen.

Speichern Sie die gewählte Version je Auftrag. Laut Referenz muss eine Erweiterung dieselbe Version wie der Quelltrack verwenden. Eine Versionsauswahl für neue Songs darf daher die Version späterer Erweiterungsanfragen nicht stillschweigend überschreiben.[1]

Suno V6 vs V5.5: Versionen und Feldnamen gemeinsam migrieren

Bei einer bestehenden Integration läuft Suno V6 vs V5.5 zunächst auf die Frage hinaus, ob eine Anfrage noch fertig werden kann. reAPI führt V4, V4_5, V4_5PLUS, V4_5ALL, V5 und V5_5 als eingestellt. Das Schema akzeptiert diese Werte weiterhin, doch die Generierung schlägt fehl und wird erstattet.[1]

Es gibt damit zwei unterschiedliche Fehlerzeitpunkte. Ein nicht unterstütztes Feld kann schon beim Absenden abgewiesen werden. Eine akzeptierte alte Version kann zunächst einen Auftrag erzeugen, der später fehlschlägt. Wer nur den HTTP-Status des POST prüft, übersieht den zweiten Fall.

Kontrollieren Sie gespeicherte Vorlagen und Servervorgaben genauso wie die sichtbare Modellauswahl. Auf der Oberfläche kann „V6“ stehen, während ein Hintergrundprozess weiterhin einen alten gespeicherten Payload verschickt.

Alter AnfrageausschnittAktueller Ausschnitt
"version": "V5_5""version": "V6" für neue Songs
"customMode": false"custom_mode": false
"negativeTags": "metal""negative_tags": "metal"
"audioId": "…""audio_id": "…" bei Track-bezogenen Operationen

Die vollständige Referenz dokumentiert die Umbenennung vom 13. September 2026.[1] Aktualisieren Sie das Anfrageobjekt gezielt. Eine pauschale Textersetzung in gespeicherten Ergebnissen und anderen Integrationen kann Inhalte verändern, die gar nicht migriert werden sollten.

Erzeugen Sie für neue Aufträge zunächst einen gültigen V6-Quelltrack und testen Sie anschließend die darauf aufbauende Bearbeitung. Die Auswahl von V6 verwandelt nicht automatisch jede alte Track-ID in eine kompatible Quelle für jede Operation.

Die acht Operationen auf der V6-Seite

Die eigene V6-Seite behandelt acht Operationen. Sie teilen sich POST /api/v1/audio/generations, benötigen aber unterschiedliche Eingaben.[4]

OperationmodelRegel für version
Song erzeugensuno-musicPflicht
Generierten Track erweiternsuno-extendPflicht; Quellversion beibehalten
Hochgeladenes Audio covernsuno-upload-coverPflicht
Hochgeladenes Audio erweiternsuno-upload-extendPflicht; Quellversionsregel beachten
Gesang hinzufügensuno-add-vocalsOptional; Standard V6
Begleitung hinzufügensuno-add-instrumentalOptional; Standard V6
Hochgeladenes Audio mischensuno-mashupPflicht
Klänge erzeugensuno-soundsPflicht

Die gesamte Familie enthält 18 asynchrone Operationen. Die übrigen zehn liegen außerhalb dieser V6-Seite; das bedeutet nicht, dass alle zehn ein Versionsfeld ablehnen. suno-replace-section akzeptiert entweder eine vorhandene task_id mit audio_id oder upload_url mit version. Beim Upload ist die Version erforderlich, beim vorhandenen Track muss sie fehlen. Beide Zweige zu vermischen ist ungültig.[1]

Falls Ihre Software jeder Suno-Anfrage global version anhängt, entfernen Sie diese Annahme. Setzen Sie die Version nur in den passenden Anfragefunktionen. Auch WAV-Konvertierung, Texterstellung und Stimmoperationen haben eigene Ein- und Ausgabeformate und sind keine Kopien der Song-Anfrage.

Eine erste V6-Anfrage senden und auf Audio warten

Sie benötigen einen reAPI-Schlüssel, genügend Credits für die gewählte Operation und einen serverseitigen Speicherort für das Geheimnis. Für den Einstieg hält der Inspirationsmodus den Payload klein: prompt beschreibt den Song, das Modell verfasst den Text.[4]

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "version": "V6",
    "custom_mode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at midnight"
  }'

Lesen Sie die id des zurückgegebenen Auftrags und verwenden Sie sie im Task-Endpunkt. TASK_ID ist unten ein Platzhalter für den tatsächlichen Wert:

curl "https://reapi.ai/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

Eine erfolgreiche Übermittlung ist noch kein fertiges Audio. Fragen Sie wartende oder laufende Aufträge weiter ab, stoppen Sie bei einem Fehler und verarbeiten Sie die Ausgabe bei status: "completed". Polling verbraucht keine Credits.[4]

Bei der Vorbereitung haben wir eine V6-Generierung im produktiven Playground ausgeführt. Die fertige Antwort enthielt jeweils zwei Einträge in output.audio_urls und output.tracks. Das bestätigt die Ausgabemenge dieses Beispiels, ist aber kein Leistungs- oder Zuverlässigkeitsbenchmark.

Speichern Sie output.tracks[].id, sofern vorhanden, zusammen mit der übergeordneten Task-ID. Eine Audio-URL ersetzt keine audio_id. Garantiert wird laut Referenz eine Track-URL; leere Metadaten können fehlen. Behandeln Sie fehlende Texte, Laufzeiten oder Kennungen ausdrücklich, bevor Sie Folgeaktionen aktivieren.[4]

Für vorgegebene Liedtexte aktivieren Sie den benutzerdefinierten Modus und geben zusätzlich style und title an. Der Suno V6-Versionsparameter ändert die Bedeutung von custom_mode nicht: Eine Dauer wird im benutzerdefinierten Modus berücksichtigt, mit einem ganzzahligen Ziel zwischen 10 und 360 Sekunden.[4]

Was ein V6-Aufruf kostet

Die am 14. September geprüfte Suno V6-Preisliste nennt $0.06 beziehungsweise 60 Credits je abgeschlossener Song-Anfrage. Beide Takes sind enthalten. Durch zwei geteilt ergeben sich $0.03 je geliefertem Track. Das ist eine rechnerische Umlegung, kein separat kaufbarer Track-Preis.[3]

Nutzen Sie nur einen Take, kostet Ihr verwendbarer Song weiterhin $0.06. Jede erneute Generierung oder Folgeoperation verursacht ihre eigene Gebühr. Weder Mini noch ein kürzerer Song im zulässigen Bereich senkt den Preis dieses Aufrufs.[4]

Sound FX ist anders: Der ursprüngliche Listenwert beträgt $0.0125, die Abbuchung in ganzen Credits jedoch 13 Credits, entsprechend $0.013. Rechnen Sie im Budget mit den abgebuchten Credits, statt den Rohpreis abzurunden.[3]

Die Zugangsdaten richten Sie mit dem Suno-API-Key-Leitfaden ein. Die vollständige Preistabelle umfasst weitere Operationen; der offizielle API-Status klärt die davon getrennte Zugangsfrage.

Häufige Fragen

Ist Suno V6 über eine API verfügbar?

reAPI dokumentiert V6, V6 Mini und V6 Wild über seinen Audio-Task-Endpunkt. Das ist ein eigener Dienst neben Sunos Entwickler-Interessensformular.[4][5]

Worin unterscheiden sich die drei Varianten?

Suno positioniert V6 für Präzision, Mini für schnellere Erstellung und Wild für Experimente. Entscheiden Sie anhand eigener Abnahmekriterien; hier wird kein bezifferter Leistungsunterschied behauptet.[2]

Kosten die Varianten gleich viel?

Ja, bei derselben reAPI-Operation. Die Songgenerierung kostet für jede Variante $0.06 je abgeschlossenem Auftrag.[3][4]

Kann ich weiterhin V5_5 senden?

Das Schema akzeptiert den Wert, aber der dokumentierte Generierungsweg scheitert, weil die Version eingestellt wurde. Nutzen Sie für neue Aufträge einen aktuellen V6-Wert.[1]

Welche Suno V6-Funktionen erfordern Anpassungen?

Prüfen Sie Versionsauswahl, snake_case-Felder und operationsabhängige Eingaben. Funktionen aus der Produktankündigung werden nicht automatisch zu Anfrageparametern.[1]

Ist version optional?

Von den acht Operationen der V6-Seite nur bei suno-add-vocals und suno-add-instrumental. Dort gilt standardmäßig V6; Songgenerierung verlangt einen expliziten Wert.[4]

Wie lang kann ein Track sein?

Das dokumentierte duration-Ziel im benutzerdefinierten Modus liegt bei 10–360 Sekunden. Im Inspirationsmodus gilt es nicht.[4]

Liefert jede Operation zwei Songs?

Nein. Das Preisbeispiel mit zwei Takes betrifft die Songgenerierung. Texte, WAV, Trennung und weitere Operationen haben andere Ausgabetypen und müssen entsprechend ausgewertet werden.[1]

Anfrage migrieren und Track-Kennungen erhalten

Verfolgen Sie zunächst eine Anfrage mit aktueller Version bis zum Abschluss. Prüfen Sie das gesendete JSON, speichern Sie Task- und Track-IDs und testen Sie danach die nächste tatsächlich benötigte Operation. Dieser vollständige Ablauf samt Fehlerbehandlung ist das sinnvolle Abnahmekriterium für eine Suno V6 API-Migration.

Quellen

  1. reAPI. Suno API reference. Retrieved September 14, 2026 from reapi.ai/docs/suno.
  2. Suno. Introducing v6. Published September 9, 2026; retrieved September 14, 2026 from blog.suno.com/blog/introducing-v6.
  3. reAPI. Suno V6 public rate card. Retrieved September 14, 2026 from reapi.ai/models/suno-v6.
  4. reAPI. Suno V6: versions, parameters and billing. Retrieved September 14, 2026 from reapi.ai/docs/suno-v6.
  5. Suno. Developer API intake form. Retrieved September 14, 2026 from sunomusic.typeform.com/apiform.