Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
audio_weight | Nein | How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only. ≥ 0 · ≤ 1 |
generate_lyrics | Nein | Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off. Standardwert: true |
image_urls | Nein | Bilder, die die Stimmung vorgeben; die Musik übernimmt ihr Gefühl. |
instrumental | Nein | Nur Musik, kein Gesang. Standardwert: false |
lyrics | Nein | Schreib deinen eigenen Text oder überlass ihn dem Modell. |
negative_prompt | Nein | Stile oder Klänge, die nicht im Track vorkommen sollen. |
persona_id | Nein | ID of an existing Suno persona to reuse its style or voice. |
persona_model | Nein | Whether persona_id is a style persona or a voice persona. style_persona · voice_persona |
prompt | Ja | Describe the song: genre, mood, tempo, instruments and voice. With lyrics or an instrumental this is the style (up to 1,000 characters); with no lyrics the model writes the words from it. |
reference_audio_urls | Nein | Ton zum Angleichen: eine Stimme, Musik oder ein Rhythmus. |
reference_video_urls | Nein | Ein Video, zu dem die Musik passen soll. |
style_weight | Nein | How closely to follow the style in the prompt, from 0 to 1. ≥ 0 · ≤ 1 |
title | Nein | Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song. |
variety | Nein | How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max. ≥ 0 · ≤ 4 |
vocal_gender | Nein | Make a female or male lead vocal more likely. Applies with lyrics. female · male |
weirdness | Nein | How experimental the song may get, from 0 (conventional) to 1 (unusual). ≥ 0 · ≤ 1 |
Preise
Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.
| Option | Credits pro Lauf | ≈ USD |
|---|---|---|
| Standard | 10,8 | 0,11 $ |
Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 11 Credits pro Lauf (0,11 $).
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Suno v6 API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
- Anfrage senden. Sende POST /jobs/createTask mit model suno/v6/text-to-audio und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Suno v6 API
Was kostet die Suno v6 API?
Suno v6 kostet 11 Credits (0,11 $) pro Lauf. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.
Wie lautet der Modellname von Suno v6 in der API?
Trag suno/v6/text-to-audio für Musik im Feld model von POST /jobs/createTask ein.
Was sagt Suno zu v6?
Laut Suno ist v6 verlässlich, präzise und liefert in jedem Genre und Stil durchgehend ausgereifte Musik. Es erschien am 9. September 2026 zusammen mit v6 Wild und v6 Mini.
Singt es meinen Text genau so?
In unseren Tests mit Standardeinstellungen ja. Ein Songtext mit 11 Zeilen wurde Wort für Wort in der geschriebenen Reihenfolge gesungen; Abschnitts-Tags wie [Chorus] wurden nicht gesungen, und der Refrain wurde nicht von sich aus wiederholt.
Werde ich belastet, wenn eine Anfrage abgelehnt wird oder fehlschlägt?
Nein. Der für die Anfrage reservierte Betrag wird vollständig freigegeben.
Kann ich wählen, wer singt?
Teilweise. Beschreiben Sie die Stimme im Stil-Prompt, etwa eine selbstbewusste weibliche Leadstimme. Mit eigenem Songtext oder aktivem instrumental können Sie außerdem vocal_gender auf female oder male setzen; das ist eine Präferenz, keine Garantie, und wie oft sie greift, haben wir nicht gemessen. Ein Duett, das in einem einzigen Satz gewünscht wurde, kam in unserem Test als Solo zurück; nennen Sie also eine Stimme, wenn es darauf ankommt.
Welche Limits hat die Suno v6 API?
Referenzbilder: 5; Referenz-Audio: 1; Referenzvideos: 1; Prompt-Länge (Zeichen): 3,000. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Suno v6 testen, ohne Code zu schreiben?
Ja. Der Playground führt Suno v6 mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.
Alle Suno-Modelle
Suno v6 ist die verlässliche Wahl für Songs, die du schon im Kopf hast. v6 Wild nimmt überraschendere, strukturreichere Wendungen, v6 Mini ist der schnelle Skizzenblock – alle zum selben Preis pro Durchlauf.
