Einführung
Suno v6 auf SpicyAPI ist eine Text-zu-Musik-Aufgabe, die pro Anfrage zwei fertige Versionen eines Songs liefert, jeweils eine vollständige MP3 mit Gesang und Begleitung. Sie beschreiben den Stil in prompt und tragen, falls vorhanden, die zu singenden Worte in lyrics ein. Laut Suno ist v6 das verlässliche, präzise Modell, und in unseren Tests sang es einen Songtext Wort für Wort in der richtigen Reihenfolge. Ein fester Preis deckt die ganze Anfrage ab.
Wichtige Funktionen und Highlights
Jedes Mal zwei Aufnahmen
Jede Anfrage liefert zwei vollständige Versionen des Songs. Es sind keine Ausschnitte voneinander: Sie können sich in Arrangement und Länge unterscheiden, sodass Sie die behalten können, die Ihnen gefällt. Der feste Preis deckt beide ab.
Ihr Songtext, gesungen wie geschrieben
Ein Songtext mit 11 Zeilen kam Zeile für Zeile in der von uns geschriebenen Reihenfolge gesungen zurück. Abschnitts-Tags wie [Verse] und [Chorus] gliederten den Song, ohne gesungen zu werden, und der Refrain wiederholte sich nur, wenn der Text ihn wiederholte.
Drei Wege, mit den Worten umzugehen
Bringen Sie Ihren eigenen Songtext mit, lassen Sie das Modell ihn aus prompt schreiben (generate_lyrics ist standardmäßig an) oder schalten Sie instrumental ein für keinen Gesang. Feinsteuerungen wie title, vocal_gender, style_weight, weirdness, variety und Personas gelten, wenn Sie Ihren eigenen Songtext mitbringen oder instrumental wählen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Der Stil-Prompt. Mit eigenem Songtext oder aktivem instrumental beschreibt er nur den Stil: Genre, Tempo, Instrumente, Stimme, Stimmung, bis zu 1.000 Zeichen. mindestens 1 Zeichen · höchstens 3000 Zeichen |
lyrics | Nein | Die gesungenen Worte, bis zu 5.000 Zeichen, eine Zeile pro Zeile. mindestens 1 Zeichen · höchstens 5000 Zeichen |
generate_lyrics | Nein | Standardmäßig an: Ist lyrics leer und instrumental aus, schreibt das Modell den Songtext aus dem prompt. Von Ihnen gelieferte Texte werden nie umgeschrieben. Standardwert: |
instrumental | Nein | Einschalten für einen Track ohne Gesang. prompt beschreibt dann den Stil (bis zu 1.000 Zeichen), und lyrics ist nicht nötig. Standardwert: |
title | Nein | Name des Songs, bis zu 80 Zeichen. Gilt mit eigenem Songtext oder bei aktivem instrumental; bei generiertem Songtext wählt das Modell den Titel. mindestens 1 Zeichen · höchstens 80 Zeichen |
negative_prompt | Nein | Stile, Klänge oder Stimmungen, die aus dem Song herausbleiben sollen, als kurze kommagetrennte Liste, zum Beispiel „harsh distortion, spoken word“. Optional. mindestens 1 Zeichen · höchstens 500 Zeichen |
vocal_gender | Nein | Lenkt die Leadstimme eher weiblich oder männlich. Das ist eine Präferenz, keine Garantie, und wie oft sie greift, haben wir nicht getestet. |
style_weight | Nein | Wie streng der Song Ihrem Stil-Prompt folgt, von 0 bis 1 in Schritten von 0,01. Gilt nur mit eigenem Songtext oder bei aktivem instrumental; sonst kommt ein klarer Fehler. |
weirdness | Nein | Wie weit sich der Song vom Erwartbaren entfernen darf, von 0 (konventionell) bis 1 (abenteuerlich), in Schritten von 0,01. |
audio_weight | Nein | Wie stark das Eingabe-Audio das Ergebnis prägt, von 0 bis 1 in Schritten von 0,01. Suno unterstützt es nicht für Songs ohne Gesang. |
variety | Nein | Wie stark das Modell Ihren Stil-Prompt abwandelt, als ganze Zahl von 0 (aus: Ihre Stil-Tags werden genau wie geschrieben verwendet) bis 4 (Maximum). Standard ist 1. |
persona_id | Nein | Die ID einer gespeicherten Suno-Persona oder Stimme, die den Song singt oder spielt. Optional. mindestens 1 Zeichen · höchstens 200 Zeichen |
persona_model | Nein | Sagt dem Modell, was |
image_urls | Nein | Bis zu 5 Stimmungsbilder (JPEG, PNG, WebP oder BMP, je bis zu 10 MB), an denen sich das Modell für die Anmutung des Songs orientiert. höchstens 5 Einträge |
reference_video_urls | Nein | Ein Referenzvideo (MP4, MOV oder WebM, bis zu 100 MB und 241 Sekunden), um das herum der Song entsteht, etwa um es zu vertonen. höchstens 1 Einträge |
reference_audio_urls | Nein | Eine Referenz-Audiodatei (6 Sekunden bis 30 Minuten, bis zu 500 MB), die den Song inspiriert. Nur mit generiertem Songtext: kein Songtext, instrumental aus, |
Preis
$0.072 / Anfrage
Ein fester Preis pro Anfrage, der beide Versionen des Songs abdeckt, egal wie lang sie sind.
Anwendungsfälle
Songs, die Sie schon geschrieben haben
Gedichte, Toasts, Jingles und erzählende Songs: Behalten Sie den Text, wählen Sie Genre und Stimme und vergleichen Sie zwei Versionen. Die Songs dauerten von etwa anderthalb Minuten bei einem kurzen Songtext bis zu über zwei Minuten bei einem vollständigen.
Musik, die einem Bild oder Clip folgt
Mit generiertem Songtext können Sie bis zu 5 Stimmungsbilder, ein Referenzvideo oder ein Referenz-Audio senden, und das Modell schreibt einen Song darum herum. Für eine Untermalung ohne Worte schalten Sie instrumental ein.
Prompt-Leitfaden und Praxistipps
Beschreiben Sie den Sound, nicht den Künstler
Schreiben Sie Genre, Tempo in bpm, zwei oder drei Instrumente und die Art der Stimme: „soft neo-soul ballad, 78 bpm, warm female lead vocal, Rhodes piano“. Prompts, die echte Künstler nennen, werden abgelehnt, beschreiben Sie also den Sound.
Tags für die Abschnitte
Setzen Sie [Intro], [Verse], [Chorus], [Bridge] und [Outro] in eigene Zeilen und wiederholen Sie den Refrain-Text dort, wo er wiederkehren soll. Mehr Zeilen ergeben einen längeren Song; eine Dauer-Einstellung gibt es nicht.
Wissen, was der Filter stoppt
Suno lehnt die stärksten Texte und Beschreibungen innerhalb von Sekunden ab und berechnet sie nicht. Mildere Texte und deutliche Ausdrücke werden gesungen, halten Sie das Geschriebene also auf dieser Seite der Grenze.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
