Musikgenerierung

Fähigkeit zur Musikgenerierung

Überblick

Diese Fähigkeit generiert Songs (vokal oder instrumental) aus einer strukturierten JSON-Spezifikation über die MiniMax-Musikgenerierungs-API (/v1/music_generation). Sie beschreiben Stil/Stimmung/Szene im prompt, geben optional lyrics an, und das Skript gibt eine MP3-Datei zurück.

Arbeitsablauf

Schritt 1: Anforderungen verstehen

Identifizieren Sie den gewünschten Stil, die Stimmung, die Szene, die Sprache und ob der Benutzer Gesang oder eine reine Instrumentalspur wünscht. Entscheiden Sie, ob Sie Texte bereitstellen oder das Modell diese schreiben lassen.

Schritt 2: Die Spezifikations-JSON erstellen

Schreiben Sie eine JSON-Datei in /mnt/user-data/workspace/ mit dem Namen {deskriptiver-name}.json:

{
  "title": "Rainy Night Cafe",
  "prompt": "Indie-Folk, melancholisch, introspektiv, allein gehen, Café",
  "lyrics": "[verse]\nStraßenlaternen leuchten, der Nachtwind seufzt\n[chorus]\nDie Holztür aufstoßen, warme Luft drinnen"
}

Felder:

• title (optional): ein lesbarer Name.
• prompt (erforderlich): Stil, Stimmung und Szene. Bestimmt den musikalischen Charakter.
• lyrics (optional): Liedtexte. Verwenden Sie \n zwischen den Zeilen und Struktur-Tags wie [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge], [Outro].
• is_instrumental (optional, bool): setzen Sie true für eine reine Instrumentalspur (keine Texte erforderlich).

Verhalten:

• lyrics angegeben → diese Texte werden gesungen.
• is_instrumental: true → instrumental, kein Gesang.
• keines von beidem → das Modell schreibt automatisch Texte aus dem prompt (lyrics_optimizer).

Schritt 3: Generierung ausführen

python /mnt/skills/public/music-generation/scripts/generate.py \
  --prompt-file /mnt/user-data/workspace/rainy-night-cafe.json \
  --output-file /mnt/user-data/outputs/rainy-night-cafe.mp3

Parameter:

• --prompt-file: Absoluter Pfad zur JSON-Spezifikation (erforderlich).
• --output-file: Absoluter Pfad für die Ausgabe-MP3 (erforderlich).

[!HINWEIS] Lesen Sie die Python-Datei NICHT aus, rufen Sie sie einfach mit den Parametern auf.

Umgebung

• MINIMAX_API_KEY (erforderlich): Ihr MiniMax-Schnittstellenschlüssel.
• MINIMAX_API_HOST (optional): Standard https://api.minimaxi.com.
• MINIMAX_MUSIC_MODEL (optional): Standard music-2.6-free (funktioniert für alle API-Key-Benutzer); zahlende/Token-Plan-Benutzer können music-2.6 für höhere Limits setzen.

Ausgabeverarbeitung

• Musik wird als MP3 gespeichert (normalerweise in /mnt/user-data/outputs/).
• Teilen Sie die generierte Datei dem Benutzer mit dem present_files-Tool mit.
• Bieten Sie an, bei Bedarf Stil oder Texte zu überarbeiten.

Hinweise

• Halten Sie prompt fokussiert auf Stil/Stimmung/Szene; setzen Sie die tatsächlich gesungenen Wörter in lyrics.
• Für nicht-englische Lieder schreiben Sie lyrics in der Zielsprache.