Suno Musikgenerierung Beta

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

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)

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

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

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

Songtitel

Beschreibung:

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

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

Beispiele:

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

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

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

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

Audiogewichtung, steuert die Gewichtung der Audio-Merkmale

Bereich: 0.0 ~ 1.0, eine Dezimalstelle

Beschreibung:

• Ein Wert von 0 wird als nicht gesetzt behandelt

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

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

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

Zeitstempel der Aufgabenerstellung

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

Tatsächlich verwendeter Modellname

Aufgabentyp

Aufgabenfortschritt in Prozent (0-100)

Aufgabenstatus

Aufgaben-Ausgabetyp