Zum Hauptinhalt springen
POST
/
v1
/
audios
/
generations
curl --request POST \
  --url https://api.evolink.ai/v1/audios/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno-v4.5",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'
{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v5",
  "object": "audio.generation.task",
  "progress": 100,
  "result_data": [
    {
      "result_id": "555f4ea2-cfef-4622-8355-baa5f2ce6a59",
      "duration": 91.2,
      "tags": "R&B",
      "title": "Forget Me Nots",
      "image_url": "https://media.evolink.ai/xxx.jpeg",
      "audio_url": "https://media.evolink.ai/xxx.mp3",
      "stream_audio_url": "https://media.evolink.ai/xxx.mp3"
    }
  ],
  "results": [
    "https://media.evolink.ai/xxx.mp3",
    "https://media.evolink.ai/yyy.mp3"
  ],
  "status": "completed",
  "task_info": {
    "can_cancel": false
  },
  "type": "audio"
}

Autorisierungen

​
Authorization
string
header
erforderlich

##Alle APIs erfordern Bearer-Token-Authentifizierung##

API-Schlüssel erhalten:

Besuchen Sie die API-Schlüsselverwaltungsseite, um Ihren API-Schlüssel zu erhalten

Zum Anfrage-Header hinzufügen:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
erforderlich

Modellname

Verfügbare Optionen:

  • suno-v4: V4-Version, verbesserte Gesangsqualität, bis zu 4 Minuten, Prompt max. 3000 Zeichen, Stil max. 200 Zeichen
  • suno-v4.5: V4.5-Version (Empfohlen), intelligentere Prompts, schnellere Generierung, bis zu 8 Minuten, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen
  • suno-v4.5plus: V4.5+ erweiterte Version, reichere Klänge, neue kreative Methoden, bis zu 8 Minuten, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen
  • suno-v4.5all: V4.5 Vollversion, intelligentere Prompts, schnellere Generierung, bis zu 8 Minuten, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen
  • suno-v5: V5 neueste Version, überlegener musikalischer Ausdruck, schnellere Generierung, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen
Verfügbare Optionen:
suno-v4,
suno-v4.5,
suno-v4.5plus,
suno-v4.5all,
suno-v5
Beispiel:

"suno-v4.5"

​
custom_mode
boolean
erforderlich

Benutzerdefinierten Modus aktivieren

Beschreibung:

  • false: Einfacher Modus, nur prompt angeben, KI generiert Liedtext und Stil automatisch
  • true: Benutzerdefinierter Modus, ermöglicht Feinsteuerung von style, title, Liedtext usw.

Erforderliche Parameter im benutzerdefinierten Modus:

  • style: Erforderlich
  • title: Erforderlich
  • prompt: Erforderlich wenn instrumental=false (wird als Liedtext verwendet)
Beispiel:

false

​
instrumental
boolean
erforderlich

Instrumentalmusik generieren (ohne Gesang)

Beschreibung:

  • false: Musik mit Gesang generieren
  • true: Instrumental-/Hintergrundmusik ohne Gesang generieren

Hinweis:

  • Im nicht-benutzerdefinierten Modus beeinflusst dieser Parameter die Pflichtfelder nicht
  • Im benutzerdefinierten Modus wird prompt optional, wenn auf true gesetzt
Beispiel:

false

​
prompt
string

Prompt zur Beschreibung des gewünschten Musikinhalts

Nicht-benutzerdefinierter Modus (custom_mode=false):

  • Erforderlich, dient als Musikbeschreibung, KI generiert Liedtext und Stil automatisch
  • Maximale Länge: 500 Zeichen

Benutzerdefinierter Modus (custom_mode=true):

  • Erforderlich wenn instrumental=false, wird als exakter Liedtext verwendet
  • Optional wenn instrumental=true
  • Maximale Länge: 3000 Zeichen für V4, 5000 Zeichen für V4.5+

Vorschläge zum Liedtextformat:

  • Verwenden Sie Tags wie [Verse], [Chorus], [Bridge] zur Strukturierung des Liedtextes
Beispiel:

"A cheerful summer pop song about road trips and freedom"

​
style
string

Musikstil-Spezifikation

Beschreibung:

  • Erforderlich im benutzerdefinierten Modus (custom_mode=true)
  • Definiert das Genre, die Stimmung oder die künstlerische Richtung der Musik
  • Empfohlen, kommagetrennte Tags auf Englisch zu verwenden

Zeichenlimits:

  • V4: Max. 200 Zeichen
  • V4.5+: Max. 1000 Zeichen

Gängige Stil-Tags:

  • Genres: pop, rock, jazz, classical, electronic, hip-hop, r&b, country, folk
  • Stimmungen: happy, sad, energetic, calm, romantic, dark, uplifting
  • Instrumente: piano, guitar, drums, bass, violin, saxophone, synthesizer
  • Gesang: male vocals, female vocals, choir, harmonies
  • Tempo: slow, fast, upbeat, groovy, 120bpm
Beispiel:

"pop, electronic, upbeat, female vocals"

​
title
string

Songtitel

Beschreibung:

  • Erforderlich im benutzerdefinierten Modus (custom_mode=true)
  • Wird in der Player-Oberfläche und im Dateinamen angezeigt
  • Maximale Länge: 80 Zeichen
Maximum string length: 80
Beispiel:

"Sommerträume"

​
negative_tags
string

Ausgeschlossene Stile, Musikstile oder Merkmale angeben, die vermieden werden sollen

Beispiele:

  • heavy metal, screaming, sad
  • rap, fast tempo
Beispiel:

"heavy metal, screaming"

​
vocal_gender
enum<string>

Gesangs-Geschlechtspräferenz

Optionen:

  • m: Männliche Stimme
  • f: Weibliche Stimme

Hinweis:

  • Nur wirksam wenn custom_mode=true
  • Dieser Parameter erhöht nur die Wahrscheinlichkeit, kann nicht garantieren, dass das angegebene Geschlecht eingehalten wird
Verfügbare Optionen:
m,
f
Beispiel:

"f"

​
style_weight
number

Stilgewichtung, steuert die Einhaltung des angegebenen Stils

Bereich: 0.0 ~ 1.0, eine Dezimalstelle

Beschreibung:

  • Höhere Werte führen zu engerer Einhaltung des angegebenen Stils
  • Ein Wert von 0 wird als nicht gesetzt behandelt
Erforderlicher Bereich: 0 <= x <= 1
Beispiel:

0.7

​
weirdness_constraint
number

Ungewöhnlichkeitsbeschränkung, steuert den Kreativitäts-/Experimentiergrad der Ausgabe

Bereich: 0.0 ~ 1.0, eine Dezimalstelle

Beschreibung:

  • Höhere Werte führen zu kreativerer und experimentellerer Ausgabe
  • Niedrigere Werte führen zu traditionellerer und konservativerer Ausgabe
  • Ein Wert von 0 wird als nicht gesetzt behandelt
Erforderlicher Bereich: 0 <= x <= 1
Beispiel:

0.3

​
audio_weight
number

Audiogewichtung, steuert die Gewichtung der Audio-Merkmale

Bereich: 0.0 ~ 1.0, eine Dezimalstelle

Beschreibung:

  • Ein Wert von 0 wird als nicht gesetzt behandelt
Erforderlicher Bereich: 0 <= x <= 1
Beispiel:

0.5

​
callback_url
string<uri>

HTTPS-Callback-URL für Aufgabenabschlussbenachrichtigung

Callback-Phasen:

  • Der Callback-Prozess hat drei Phasen: text (Textgenerierung), first (erster Track abgeschlossen), complete (alle abgeschlossen)
  • In einigen Fällen können die Phasen text und first übersprungen werden und direkt complete zurückgegeben werden

Sicherheitsbeschränkungen:

  • Nur HTTPS-Protokoll unterstützt
  • Callbacks an interne IP-Adressen sind verboten
  • URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

  • Timeout: 10 Sekunden
  • Maximal 3 Wiederholungsversuche bei Fehler
  • Callback-URL, die einen 2xx-Statuscode zurückgibt, gilt als erfolgreich
Beispiel:

"https://your-domain.com/webhooks/suno-callback"

Antwort

Musikaufgabe erfolgreich erstellt

​
created
integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1766319090

​
id
string

Aufgaben-ID, wird zur Abfrage des Aufgabenstatus und der Ergebnisse verwendet

Beispiel:

"task-unified-1766319089-oqs9cue4"

​
model
string

Tatsächlich verwendeter Modellname

Beispiel:

"suno-v5"

​
object
enum<string>

Aufgabentyp

Verfügbare Optionen:
audio.generation.task
​
progress
integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100
Beispiel:

100

​
result_data
object[]

Array der generierten Musikdetails, wird bei Aufgabenabschluss zurückgegeben

​
results
string<uri>[]

Array der generierten Audio-URLs, wird bei Aufgabenabschluss zurückgegeben

Beispiel:
[
  "https://media.evolink.ai/xxx.mp3",
  "https://media.evolink.ai/yyy.mp3"
]
​
status
enum<string>

Aufgabenstatus

Verfügbare Optionen:
pending,
processing,
completed,
failed
Beispiel:

"completed"

​
task_info
object

Audio-Aufgabendetails

​
type
enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:
audio
Beispiel:

"audio"