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

{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v5-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-v5-beta",
  "prompt": "A cheerful summer pop song about road trips and freedom"
}
'

{
  "created": 1766319090,
  "id": "task-unified-1766319089-oqs9cue4",
  "model": "suno-v5-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-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 neueste Version (Standardempfehlung), 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-v5.5-beta,

suno-v5-beta,

suno-v4.5plus-beta,

suno-v4.5all-beta,

suno-v4.5-beta,

suno-v4-beta

Beispiel:

"suno-v5-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: 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

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-Familie unterstützt (suno-v5-beta / suno-v5.5-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-Familie (suno-v5-beta / suno-v5.5-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

Standard:20

Gewünschte Audiodauer in Sekunden

Nur verfügbar, wenn das Modell suno-v5.5-beta (oder der kompatible Name suno-v5.5) und custom_mode=true verwendet werden. Der Wert muss eine Ganzzahl zwischen 10 und 360 sein. Ohne Angabe gilt der Upstream-Standard von 20 Sekunden. Andere Modelle und der einfache Modus unterstützen ihn nicht; die Angabe führt zu einem Parameterfehler.

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-v5-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