> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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](/de/api-manual/audio-series/suno/suno-persona-creation)-Funktion zur Wiederverwendung erstellter Gesangs-/Stilmerkmale - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum [Statusabfragen](/de/api-manual/task-management/get-task-detail) - Generierte Audio-Links sind 72 Stunden gültig, bitte speichern Sie diese umgehend - Jede Anfrage generiert mehrere Musikvariationen ## OpenAPI ````yaml de/api-manual/audio-series/suno/suno-music-generation.json POST /v1/audios/generations openapi: 3.1.0 info: title: Suno Musikgenerierungs-API description: >- Musik mit Suno-KI-Modellen generieren, unterstützt sowohl Gesangs- als auch Instrumentalmodi license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] paths: /v1/audios/generations: post: tags: - Audio Generation summary: Suno Musikgenerierungs-API description: >- - 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](/de/api-manual/audio-series/suno/suno-persona-creation)-Funktion zur Wiederverwendung erstellter Gesangs-/Stilmerkmale - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum [Statusabfragen](/de/api-manual/task-management/get-task-detail) - Generierte Audio-Links sind 72 Stunden gültig, bitte speichern Sie diese umgehend - Jede Anfrage generiert mehrere Musikvariationen operationId: createSunoMusicGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SunoMusicGenerationRequest' examples: simple_mode: summary: Einfacher Modus (Empfohlen für Anfänger) value: model: suno-v5-beta prompt: A cheerful summer pop song about road trips and freedom custom_mode_with_lyrics: summary: Benutzerdefinierter Modus (mit Liedtext) value: model: suno-v5-beta custom_mode: true instrumental: false style: pop, electronic, upbeat, female vocals, 120bpm title: Sommerträume prompt: |- [Verse 1] Driving down the highway, windows down The sun is shining on this little town Radio playing our favorite song Nothing could ever go wrong [Chorus] Summer dreams, summer nights Chasing stars and city lights With you by my side I feel so alive negative_tags: heavy metal, screaming, sad vocal_gender: f custom_mode_with_persona: summary: Benutzerdefinierter Modus (mit Persona) value: model: suno-v5-beta custom_mode: true instrumental: false style: electronic pop, synth wave, 128bpm title: Neon-Träumer prompt: |- [Verse] Unter Neonlichtern durch die Straßen Der Puls der Stadt schlägt in meinem Herzen [Chorus] Wir sind die Träumer Tanzen unter dem Sternenhimmel persona_id: 5c57d49ef834110496fae5aa14fec441 persona_model: voice_persona instrumental_mode: summary: Instrumentalmodus value: model: suno-v4.5plus-beta custom_mode: true instrumental: true style: lo-fi, chill, ambient, piano, soft drums title: Regnerischer Nachmittag responses: '200': description: Musikaufgabe erfolgreich erstellt content: application/json: schema: $ref: '#/components/schemas/AudioGenerationResponse' '400': description: Ungültige Anfrageparameter content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Nicht autorisiert, ungültiges oder abgelaufenes Token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Unzureichendes Kontingent, Aufladung erforderlich content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Zugriff verweigert content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: suno-v5-beta' type: invalid_request_error '429': description: Ratenlimit überschritten content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Interner Serverfehler content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error '503': description: Dienst vorübergehend nicht verfügbar content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: service_unavailable message: No available channel for the requested model type: api_error components: schemas: SunoMusicGenerationRequest: type: object required: - model - custom_mode - instrumental properties: model: type: string description: >- 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-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 enum: - suno-v5-beta - suno-v4.5plus-beta - suno-v4.5all-beta - suno-v4.5-beta - suno-v4-beta example: suno-v5-beta custom_mode: type: boolean description: >- 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) example: false instrumental: type: boolean description: >- 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 example: false prompt: type: string description: >- 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 example: A cheerful summer pop song about road trips and freedom style: type: string description: >- 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 example: pop, electronic, upbeat, female vocals title: type: string description: |- Songtitel **Beschreibung:** - Erforderlich im benutzerdefinierten Modus (`custom_mode=true`) - Wird in der Player-Oberfläche und im Dateinamen angezeigt - Maximale Länge: `80` Zeichen maxLength: 80 example: Sommerträume negative_tags: type: string description: >- Ausgeschlossene Stile, Musikstile oder Merkmale angeben, die vermieden werden sollen **Beispiele:** - `heavy metal, screaming, sad` - `rap, fast tempo` example: heavy metal, screaming vocal_gender: type: string description: >- 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 enum: - m - f example: f style_weight: type: number description: |- 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 minimum: 0 maximum: 1 example: 0.7 weirdness_constraint: type: number description: >- 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 minimum: 0 maximum: 1 example: 0.3 audio_weight: type: number description: |- Audiogewichtung, steuert die Gewichtung der Audio-Merkmale **Bereich:** `0.0` ~ `1.0`, eine Dezimalstelle **Beschreibung:** - Ein Wert von `0` wird als nicht gesetzt behandelt minimum: 0 maximum: 1 example: 0.5 persona_id: type: string description: >- Persona-ID, wendet eine bereits erstellte Persona auf diese Musikgenerierung an Nur verfügbar wenn `custom_mode=true`. Wird über die [Suno Persona Erstellung](/de/api-manual/audio-series/suno/suno-persona-creation)-Schnittstelle erstellt und ermöglicht konsistente Gesangs- und Stilmerkmale **Bezugsquelle:** Nach Abschluss der Persona-Aufgabe aus `result_data.persona_id` abrufen example: 5c57d49ef834110496fae5aa14fec441 persona_model: type: string description: >- Persona-Anwendungsmodus **Optionen:** 1. `style_persona`: Stilorientiert, betont musikalische Stilmerkmale (Arrangement, Rhythmus, Klangfarbe), unterstützt alle Modellversionen 2. `voice_persona`: Stimmorientiert, betont vokale Merkmale (Klangfarbe, Gesangstechnik, Stimmlage), **nur V5 unterstützt** Nur verfügbar wenn `custom_mode=true`, wird üblicherweise zusammen mit `persona_id` verwendet. Bei Verwendung von `voice_persona` muss das Modell `suno-v5-beta` sein, andernfalls wird ein Fehler zurückgegeben enum: - style_persona - voice_persona example: style_persona callback_url: type: string description: >- 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 format: uri example: https://your-domain.com/webhooks/suno-callback AudioGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1766319090 id: type: string description: >- Aufgaben-ID, wird zur Abfrage des Aufgabenstatus und der Ergebnisse verwendet example: task-unified-1766319089-oqs9cue4 model: type: string description: Tatsächlich verwendeter Modellname example: suno-v5-beta object: type: string enum: - audio.generation.task description: Aufgabentyp progress: type: integer description: Aufgabenfortschritt in Prozent (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Aufgabenstatus enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/AudioTaskInfo' description: Audio-Aufgabendetails type: type: string enum: - audio description: Aufgaben-Ausgabetyp example: audio usage: $ref: '#/components/schemas/Usage' description: Nutzungs- und Abrechnungsinformationen ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Fehlercode-Bezeichner message: type: string description: Fehlerbeschreibung type: type: string description: Fehlertyp AudioTaskInfo: type: object properties: can_cancel: type: boolean description: Ob die Aufgabe abgebrochen werden kann example: true estimated_time: type: integer description: Geschätzte Fertigstellungszeit (Sekunden) example: 120 Usage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: Abrechnungsregel enum: - per_call - per_token - per_second example: per_call credits_reserved: type: number description: Geschätzter Guthabenverbrauch minimum: 0 example: 10 user_group: type: string description: Benutzergruppenkategorie enum: - default - vip example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Alle APIs erfordern Bearer-Token-Authentifizierung## **API-Schlüssel erhalten:** Besuchen Sie die [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API-Schlüssel zu erhalten **Zum Anfrage-Header hinzufügen:** ``` Authorization: Bearer YOUR_API_KEY ``` ````