ユーザーが曲をアップロードできる製品なら、同じ音源で異なるアレンジや歌声を試せます。サーバーで音源IDを保存し、アレンジの方向性ごとにタスクを送信します。進捗を確認し、完成したバージョンをプレーヤーに渡します。
連携方法
項目 | 詳細 |
|---|---|
エンドポイント |
|
モデルパラメータ |
|
音源の指定 | purpose=remixで音源をアップロードしてupload_audio_idを取得するか、直近1か月にMurekaで生成した曲のsong_idを指定します。 |
長さ | 10–480 s |
1回の生成数 | nは既定値2、最大3 |
料金 | 新バージョン:1曲あたり$0.5(旧バージョンのV8は1曲あたり$0.2のまま)。 |
ドキュメント |
生成結果は原曲を再解釈したもので、原曲の歌手の声質は引き継がれません。特定の歌手の声質の指定や、スタイル参照用の追加音源のアップロードには現在対応していません。
モデルの指定:リクエストの model に mureka-9.5 を指定すると Remix V9.5、mureka-8 を指定すると V8 を使用できます。
活用例
- カバー・リミックスアプリ:アカペラをアップロードし、さまざまなスタイルのフルアレンジを作る。
- ショート動画・コンテンツ配信:同じBGMをロック、エレクトロニック、ジャズなどにアレンジし、映像の雰囲気に合わせる。
- ミュージシャン・制作ツール:弾き語りや鼻歌のデモから素早くフルアレンジを作り、スタイルを試す。
- ゲーム・広告のBGM:場面に合わせて同じテーマ曲の強弱を変える。Demo Bが参考になります。
APIの呼び出し手順
元の音源を用意する
この例では歌入りの音源を使います。POST /v1/files/uploadを呼び出し、purposeにremixを指定して、返されたファイルIDを保存します。V9.5は10〜480秒のMP3、M4Aに対応します。APIキーはサーバーに保存し、Bearer認証を使います。
curl --fail-with-body https://api.mureka.ai/v1/files/upload \
-H "Authorization: Bearer ${MUREKA_API_KEY}" \
-F "purpose=remix" \
-F "file=@./original.mp3"
Murekaの楽曲生成APIで作った曲なら、条件を満たすsong_idも使えます。アップロードした音源にはupload_audio_id、既存曲にはsong_idを指定し、1リクエストにつきどちらか一方を使います。入力条件はAPIリファレンスをご確認ください。
アレンジの方向性ごとにタスクを送信する
POST /v1/song/remixにアップロードIDと、目指すスタイルを記したpromptを送ります。この例ではmureka-9.5を指定し、歌入りのロック版を作ります。プレースホルダーをアップロード時に返されたIDと実際の歌詞に置き換えてください。
curl --fail-with-body https://api.mureka.ai/v1/song/remix \
-H "Authorization: Bearer ${MUREKA_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"upload_audio_id": "<UPLOAD_AUDIO_ID>",
"model": "mureka-9.5",
"lyrics": "<LYRICS_FOR_THIS_VERSION>",
"prompt": "Keep the chorus melody. Use distorted guitars and live rock drums, with a restrained verse and a bigger chorus.",
"n": 1
}'
同じpromptで複数の候補を作るにはnを使います。ロック版、EDM版、女性ボーカル版を作るなら、同じアップロードIDを使い、方向性の異なる3件のリクエストを送ります。アプリ内で元の音源ID、バージョン名、タスクIDをひも付けると、結果を対応づけられます。
進捗を確認し、試聴結果を表示する
レスポンスのタスクIDを保存し、GET /v1/song/query/{task_id}で進捗を確認します。生成中は待機状態を表示して問い合わせを続けます。成功時は音源URLを試聴に使い、失敗時はタスクIDとエラーを記録します。
curl --fail-with-body \
"https://api.mureka.ai/v1/song/query/${TASK_ID}" \
-H "Authorization: Bearer ${MUREKA_API_KEY}"
試聴ページでは同じ曲名を使い、原曲とリミックスをバージョン名で区別できます。原曲に戻りやすく、再生中のバージョンも分かります。
APIリファレンス