curl --request POST \
  --url https://api.evolink.ai/v1/audios/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "suno-v6-beta",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'

{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v6-beta",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: suno-v5-beta",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "No available channel for the requested model",
    "type": "api_error"
  }
}

Suno

Suno Musikgenerierung Beta

Suno-KI-Musikgenerierungsmodell, unterstützt die Erstellung vollständiger Musik basierend auf Textbeschreibungen oder Liedtexten
Unterstützt benutzerdefinierten Modus (Feinsteuerung von Stil, Titel, Liedtext) und einfachen Modus (KI-Autogenerierung)
Unterstützt Persona-Funktion zur Wiederverwendung erstellter Gesangs-/Stilmerkmale
Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum Statusabfragen
Generierte Audio-Links sind 72 Stunden gültig, bitte speichern Sie diese umgehend
Jede Anfrage generiert mehrere Musikvariationen

POST

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-v6-beta",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'

{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v6-beta",
  "object": "audio.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "audio",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 10,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: suno-v5-beta",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "No available channel for the requested model",
    "type": "api_error"
  }
}

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

Abwärtskompatibilität: Zuvor integrierte Modellnamen (z.B. suno-v5, suno-v4.5, suno-v4.5plus, suno-v4.5all, suno-v4) werden weiterhin unterstützt und automatisch auf die entsprechenden -beta-Versionen gemappt

Verfügbare Optionen:

suno-v6-beta: V6 (Standardempfehlung), natürlicherer Gesang, mehr Details und stärkerer musikalischer Ausdruck; unterstützt Persona und benutzerdefinierte Dauer, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen; kompatibler Modellname: suno-v6
suno-v6-mini-beta: V6 Mini, eine schlanke, schnelle Version mit ausgewogenem Verhältnis von Qualität und Geschwindigkeit; unterstützt Persona, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen; kompatibler Modellname: suno-v6-mini
suno-v6-wild-beta: V6 Wild, geht über Konventionen hinaus und bietet mutigere, unverwechselbare Stile; unterstützt Persona und benutzerdefinierte Dauer, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen; kompatibler Modellname: suno-v6-wild
suno-v5.5-beta: V5.5 mit auf den individuellen Geschmack zugeschnittenen Modellen, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen; kompatibler Modellname: suno-v5.5
suno-v5-beta: V5-Version, unterstützt Voice Persona, überlegener musikalischer Ausdruck, schnellere Generierung, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen
suno-v4.5plus-beta: 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-beta: V4.5 Vollversion, intelligentere Prompts, schnellere Generierung, bis zu 8 Minuten, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen
suno-v4.5-beta: V4.5-Version, intelligentere Prompts, schnellere Generierung, bis zu 8 Minuten, Prompt max. 5000 Zeichen, Stil max. 1000 Zeichen
suno-v4-beta: V4-Version, verbesserte Gesangsqualität, bis zu 4 Minuten, Prompt max. 3000 Zeichen, Stil max. 200 Zeichen

Verfügbare Optionen:

suno-v6-beta,

suno-v6-mini-beta,

suno-v6-wild-beta,

suno-v5.5-beta,

suno-v5-beta,

suno-v4.5plus-beta,

suno-v4.5all-beta,

suno-v4.5-beta,

suno-v4-beta

Beispiel:

"suno-v6-beta"

custom_mode

boolean

Standard:false

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)

Im einfachen Modus (custom_mode=false) wird nur prompt unterstützt: style, title, negative_tags, vocal_gender, style_weight, weirdness_constraint, audio_weight, persona_id, persona_model, duration werden in diesem Modus nicht unterstützt. Die Schnittstelle lehnt sie nicht garantiert ab, aber diese Parameter haben keinerlei Auswirkung auf das Generierungsergebnis — für eine Feinsteuerung bitte custom_mode=true verwenden

Beispiel:

false

instrumental

boolean

Standard:false

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: 3000 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 und höher (einschließlich der V6-Familie)

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 und höher (einschließlich der V6-Familie): 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

Im einfachen Modus (custom_mode=false) nicht unterstützt: In diesem Modus wird der Stil von der KI automatisch anhand von prompt erzeugt, die Angabe dieses Parameters hat keine Wirkung.

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

Im einfachen Modus (custom_mode=false) nicht unterstützt: In diesem Modus wird der Titel von der KI automatisch erzeugt, die Angabe dieses Parameters hat keine Wirkung.

Maximum string length: 80

Beispiel:

"Sommerträume"

negative_tags

string

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

Beschreibung:

Maximale Länge: 200 Zeichen (bei allen Modellen gleich)

Beispiele:

heavy metal, screaming, sad
rap, fast tempo

Nur unterstützt, wenn custom_mode=true; im einfachen Modus hat die Angabe keine Wirkung.

Maximum string length: 200

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
Im einfachen Modus (custom_mode=false) nicht unterstützt, die Angabe hat keine Wirkung

Verfügbare Optionen:

m,

f

Beispiel:

"f"

style_weight

number

Stilgewichtung, steuert die Einhaltung des angegebenen Stils

Bereich: 0.0 ~ 1.0, bis zu zwei Dezimalstellen und ein Vielfaches von 0.01

Beschreibung:

Höhere Werte führen zu engerer Einhaltung des angegebenen Stils
0 ist ein gültiger Wert, bedeutet keine Einhaltung des angegebenen Stils und wird an das Modell gesendet

Nur unterstützt, wenn custom_mode=true; im einfachen Modus hat die Angabe keine Wirkung.

Erforderlicher Bereich: 0 <= x <= 1Muss ein Vielfaches sein von 0.01

Beispiel:

0.7

weirdness_constraint

number

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

Bereich: 0.0 ~ 1.0, bis zu zwei Dezimalstellen und ein Vielfaches von 0.01

Beschreibung:

Höhere Werte führen zu kreativerer und experimentellerer Ausgabe
Niedrigere Werte führen zu traditionellerer und konservativerer Ausgabe
0 ist ein gültiger Wert und wird an das Modell gesendet

Nur unterstützt, wenn custom_mode=true; im einfachen Modus hat die Angabe keine Wirkung.

Erforderlicher Bereich: 0 <= x <= 1Muss ein Vielfaches sein von 0.01

Beispiel:

0.3

audio_weight

number

Audiogewichtung, steuert die Gewichtung der Audio-Merkmale

Bereich: 0.0 ~ 1.0, bis zu zwei Dezimalstellen und ein Vielfaches von 0.01

Beschreibung:

0 ist ein gültiger Wert und wird an das Modell gesendet

Nur unterstützt, wenn custom_mode=true; im einfachen Modus hat die Angabe keine Wirkung.

Erforderlicher Bereich: 0 <= x <= 1Muss ein Vielfaches sein von 0.01

Beispiel:

0.5

persona_id

string

Persona-ID, wendet eine bereits erstellte Persona auf diese Musikgenerierung an

Nur verfügbar wenn custom_mode=true. Wird über die Suno Persona Erstellung-Schnittstelle erstellt und ermöglicht konsistente Gesangs- und Stilmerkmale

Bezugsquelle: Nach Abschluss der Persona-Aufgabe aus result_data.persona_id abrufen

Im einfachen Modus (custom_mode=false) nicht unterstützt.

Nur von Modellen der V5- und V6-Familien unterstützt (suno-v5-beta / suno-v5.5-beta / suno-v6-beta / suno-v6-mini-beta / suno-v6-wild-beta einschließlich der kompatiblen Namen ohne -beta); bei anderen Modellen führt die Angabe zu einem Parameterfehler.

Beispiel:

"5c57d49ef834110496fae5aa14fec441"

persona_model

enum<string>

Persona-Anwendungsmodus

Optionen:

style_persona: Stilorientiert, betont musikalische Stilmerkmale wie Arrangement, Rhythmus und Klangfarbe
voice_persona: Stimmorientiert, betont vokale Merkmale wie Klangfarbe, Gesangstechnik und Stimmlage

Beide Modi sind nur für Modelle der V5- und V6-Familien (suno-v5-beta / suno-v5.5-beta / suno-v6-beta / suno-v6-mini-beta / suno-v6-wild-beta einschließlich der kompatiblen Namen ohne -beta) verfügbar und erfordern custom_mode=true. Sie müssen zusammen mit persona_id verwendet werden: persona_model allein ohne persona_id zu senden hat keine Wirkung (persona_id kann allein verwendet werden).

Verfügbare Optionen:

style_persona,

voice_persona

Beispiel:

"style_persona"

duration

integer

Gewünschte Audiodauer in Sekunden

Nur verfügbar, wenn custom_mode=true und das Modell suno-v5.5-beta, suno-v6-beta, suno-v6-mini-beta oder suno-v6-wild-beta ist (oder der entsprechende kompatible Name ohne -beta). Der Wert muss eine ganze Zahl von 10 bis 360 sein. Andere Modelle und der einfache Modus unterstützen diesen Parameter nicht; seine Angabe führt zu einem Parameterfehler.

Die Dauersteuerung unterscheidet sich je nach Modell (nach Möglichkeit, eine exakte Dauer ist nicht garantiert):

suno-v6-wild-beta, suno-v5.5-beta: Halten die angegebene Dauer in der Regel ein
suno-v6-beta: Mindestens 60 Sekunden angeben; bei Werten unter 60 Sekunden werden üblicherweise trotzdem etwa 60 Sekunden erzeugt
suno-v6-mini-beta: Der Dauerparameter hat derzeit keine Wirkung; üblicherweise werden etwa 3 Minuten Musik erzeugt

Einzelne Titel derselben Anfrage können von der angegebenen Dauer abweichen. Wird der Parameter weggelassen, bestimmt das Modell die Dauer selbst (üblicherweise 3–6 Minuten). Die Abrechnung erfolgt pro Anfrage und hängt nicht von der tatsächlichen Dauer ab.

Erforderlicher Bereich: 10 <= x <= 360

Beispiel:

120

callback_url

string<uri>

HTTPS-Callback-URL für den terminalen Aufgabenstatus

Callback-Zeitpunkt:

GroAPI sendet genau einen Callback, wenn die Aufgabe einen Endstatus erreicht: completed, failed oder cancelled
Upstream-Zwischenphasen wie text und first werden nicht weitergeleitet
Der Callback-Body entspricht der Aufgabendetailstruktur von GET /v1/tasks/{id}

Sicherheitsbeschränkungen:

Nur HTTPS
Callbacks an interne IP-Adressen sind verboten
URL-Länge maximal 2048 Zeichen

Callback-Mechanismus:

Timeout pro Versuch: 10 Sekunden
Nach einem fehlgeschlagenen Erstversuch maximal 3 Wiederholungen
Eine 2xx-Antwort gilt als erfolgreich

Beispiel:

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

Antwort

Musikaufgabe erfolgreich erstellt

created

integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1766319090

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-v6-beta"

object

enum<string>

Aufgabentyp

Verfügbare Optionen:

audio.generation.task

progress

integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100

Beispiel:

0

status

enum<string>

Aufgabenstatus

Verfügbare Optionen:

pending,

processing,

completed,

failed,

cancelled

Beispiel:

"pending"

task_info

object

Audio-Aufgabendetails

Show child attributes

type

enum<string>

Aufgaben-Ausgabetyp

Verfügbare Optionen:

audio

Beispiel:

"audio"

usage

object

Nutzungs- und Abrechnungsinformationen

Show child attributes

Bildserie

Videoserie

Audioserie

Textserie

Kontoverwaltung

Aufgabenverwaltung

Dateiverwaltung

Suno Musikgenerierung Beta

Autorisierungen

Body

Antwort