Suno v6 Wild API-Referenz

Mit einem einzigen PopNow-API-Schlüssel rufst du Suno v6 Wild aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller: Suno
Ergebnis: Audio
Ab: 10.8 Credits pro Anfrage ($0.108)
Modell-IDs: suno/v6-wild/text-to-audio

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Musik

suno/v6-wild/text-to-audio

Preis

Option	Credits (pro Anfrage)	US-Dollar
`Standard`	10.8	$0.108

Parameter

Feld	Typ	Standardwert	Erlaubt	Bedeutung
`prompt`Pflicht	`string`	—	bis zu 3.000 Zeichen	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.
`lyrics`Optional	`string`	—	bis zu 5.000 Zeichen	Words to sing, sung in order. Section tags such as [Verse], [Chorus] and [Bridge] shape the song and are not sung.
`generate_lyrics`Optional	`boolean`	`true`	—	Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off.
`instrumental`Optional	`boolean`	`false`	—	Generate music with no vocals.
`title`Optional	`string`	—	bis zu 80 Zeichen	Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song.
`negative_prompt`Optional	`string`	—	bis zu 500 Zeichen	Styles or elements to keep out of the song.
`vocal_gender`Optional	`string`	—	female, male	Make a female or male lead vocal more likely. Applies with lyrics.
`style_weight`Optional	`number`	—	0 bis 1	How closely to follow the style in the prompt, from 0 to 1.
`weirdness`Optional	`number`	—	0 bis 1	How experimental the song may get, from 0 (conventional) to 1 (unusual).
`audio_weight`Optional	`number`	—	0 bis 1	How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only.
`variety`Optional	`integer`	—	0 bis 4	How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max.
`persona_id`Optional	`string`	—	bis zu 200 Zeichen	ID of an existing Suno persona to reuse its style or voice.
`persona_model`Optional	`string`	—	style_persona, voice_persona	Whether persona_id is a style persona or a voice persona.
`image_urls`Optional	`array<string (uri)>`	—	bis zu 5 Einträge	Up to 5 mood images (JPEG, PNG or WebP, 10 MB each). Only when the model writes the lyrics.
`reference_video_urls`Optional	`array<string (uri)>`	—	bis zu 1 Einträge	One reference video (MP4 or WebM, up to 100 MB and 241 seconds). Only when the model writes the lyrics.
`reference_audio_urls`Optional	`array<string (uri)>`	—	bis zu 1 Einträge	One reference audio clip (MP3 or WAV, 6 seconds to 30 minutes). Only when the model writes the lyrics.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "suno/v6-wild/text-to-audio",
  "input": {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, hand claps and a catchy whistled hook"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"