音楽
submit_music は生成 jobId を返します。すべての結果がメディアプールに保存されるまで track_progress を呼び出します。配置、トリミング、ループ、フェード、ダッキングはタイムライン操作として残ります。
プロバイダーとモード
| プロバイダー | モード | リファレンス |
|---|---|---|
mureka | instrumental、song、prompt-song、soundtrack、track | references/mureka.md |
minimax | t2m、cover | references/minimax.md |
atlas | t2m | references/atlas.md |
sonilo | v2m | references/sonilo.md |
名前付き/設定済みのベンダーを選択します。通常のBGMにはデフォルトで Mureka インストゥルメンタルを使用します。ボーカルやリファレンスコントロールが必要な場合は Mureka の song/prompt-song を使用し、画像/動画駆動のスコアリングには Mureka soundtrack を、楽曲/音声ソースからのステム/トラック生成には track モードを使用します。テキストから音楽への変換やカバーモデルには MiniMax を、スキーマベースの非同期オーディオAPIによるテキストから音楽への変換には Atlas Cloud を、テキスト説明ではなく完成したカット（プロジェクト動画アセット）から音楽を構成する場合には Sonilo v2m を使用します。
共通ワークフロー
- プロバイダー、モード、有料バリエーションが複数必要かどうかを確認します。
- プロバイダーのリファレンスを読み、そのプロバイダーのパラメータのみを渡します。
- 一度送信し、
track_progress({ target:"generation", action:"wait", jobIds:[jobId] })を呼び出します。 countが複数の結果を生成した場合は、すべての返されたアセットを使用します。従来のresultフィールドのみが存在すると仮定しないでください。- 実際の長さがわかってからタイムラインに配置/トリミング/ダッキングを行います。
例
// Mureka インストゥルメンタル（デフォルト count は意図的に 1）
submit_music({ provider: "mureka", mode: "instrumental", prompt: "Warm lo-fi piano bed under narration", count: 1 });
// Mureka 歌詞付き楽曲
submit_music({
provider: "mureka", mode: "song", prompt: "Bright modern pop", gender: "female", count: 2,
lyrics: "[Verse]\nCity lights open the night\n[Chorus]\nWe build the future in real time",
});
// Mureka プロンプトソング
submit_music({ provider: "mureka", mode: "prompt-song", prompt: "A hopeful road-trip anthem", styles: ["pop", "folk"] });
// プロジェクト動画または画像のスコアリング
submit_music({ provider: "mureka", mode: "soundtrack", sourceAssetId: "videoAssetId", prompt: "Tense restrained documentary score" });
// Mureka 楽曲IDからステムを生成
submit_music({ provider: "mureka", mode: "track", songId: "song-id", trackType: "Drums", prompt: "Tight punchy acoustic drums" });
// MiniMax インストゥルメンタル / ボーカル
submit_music({ provider: "minimax", mode: "t2m", prompt: "Upbeat electronic tech intro", isInstrumental: true });
submit_music({ provider: "minimax", mode: "t2m", prompt: "Rainy night pop", lyricsOptimizer: true });
// MiniMax プロジェクト音声アセットからのカバー
submit_music({ provider: "minimax", mode: "cover", prompt: "Warm acoustic coffee-shop cover", referenceAssetId: "audioAssetId" });
// Atlas Cloud テキストから音楽
submit_music({ provider: "atlas", mode: "t2m", prompt: "Cinematic ambient score with restrained piano", isInstrumental: true });
// Sonilo レンダリングカットからの動画から音楽（プロンプトは任意）
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId" });
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId", prompt: "Warm indie folk, no drums" });
ルール
- 明示的なリクエストがあった場合のみ生成します。
count2～3 はプロバイダーの課金を増やす可能性があるため、バリエーションを黙って追加しないでください。 - Mureka の
stream:trueはプロバイダーのストリーミングタスクフェーズを有効にしますが、OpenChatCut は引き続き耐久性のある最終ファイルを待ちます。 - MiniMax カバーには、設定済みの
music-cover*モデルと、referenceAssetIdまたはcoverFeatureIdのいずれか 1 つが必要です。coverFeatureIdには歌詞も必要です。 - Atlas Cloud は
t2mモードのみをサポートし、MiniMax のカバー/オプティマイザーや Mureka 固有のコントロールは受け付けません。 - MiniMax のオーディオ設定フィールドを Mureka に混ぜたり、Mureka の ID/モードを MiniMax に混ぜたりしないでください。
- 生成された音楽は正確なビート/ドロップのタイミングを保証しません。生成後にカットして位置合わせを行ってください。