音楽生成スキル
概要
このスキルは、構造化されたJSON仕様をもとに、MiniMax音楽生成API（/v1/music_generation）を使用して楽曲（ボーカルまたはインストゥルメンタル）を生成します。promptにスタイル・ムード・シーンを記述し、必要に応じてlyricsを指定すると、スクリプトがMP3ファイルを返します。
ワークフロー
ステップ1: 要件の把握
ユーザーが希望するスタイル、ムード、シーン、言語、およびボーカルあり・純粋なインストゥルメンタルの別を特定します。歌詞を提供するか、モデルに自動生成させるかを決定します。
ステップ2: 仕様JSONの作成
/mnt/user-data/workspace/ 内に {descriptive-name}.json というJSONファイルを作成します：
{
"title": "雨の夜のカフェ",
"prompt": "インディーフォーク、メランコリック、内省的、一人で歩く、カフェ",
"lyrics": "[verse]\n街灯が輝き 夜風がため息をつく\n[chorus]\n木製のドアを押す 室内は暖かい空気"
}
フィールド:
title（任意）: 人間が読める名前。prompt（必須）: スタイル、ムード、シーン。音楽のキャラクターを決定します。lyrics（任意）: 歌詞。行間は\nで区切り、[Intro]、[Verse]、[Pre Chorus]、[Chorus]、[Bridge]、[Outro]などの構造タグを使用します。is_instrumental（任意、真偽値）: 純粋なインストゥルメンタル曲にする場合はtrueを設定します（歌詞は不要）。
動作:
lyricsを指定 → その歌詞が歌われます。is_instrumental: true→ インストゥルメンタル、ボーカルなし。- どちらも指定しない → モデルが
promptから自動で歌詞を生成します（lyrics_optimizer）。
ステップ3: 生成の実行
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
パラメータ:
--prompt-file: JSON仕様への絶対パス（必須）。--output-file: 出力MP3ファイルへの絶対パス（必須）。
[!NOTE] Pythonファイルを読み込まず、パラメータを指定して直接呼び出してください。
環境設定
MINIMAX_API_KEY（必須）: MiniMaxインターフェースキー。MINIMAX_API_HOST（任意）: デフォルトhttps://api.minimaxi.com。MINIMAX_MUSIC_MODEL（任意）: デフォルトmusic-2.6-free（すべてのAPIキーユーザーが利用可能）。有料/トークンプランユーザーはmusic-2.6を設定すると上限が上がります。
出力の取り扱い
- 音楽はMP3として保存されます（通常は
/mnt/user-data/outputs/内）。 - present_filesツールを使用して生成されたファイルをユーザーと共有します。
- 必要に応じてスタイルや歌詞の調整を提案します。
注意点
promptはスタイル/ムード/シーンに集中させ、実際に歌われる言葉はlyricsに記述してください。- 非英語の楽曲の場合、
lyricsは対象言語で記述してください。