ユーザーが曲をアップロードできる製品なら、同じ音源で異なるアレンジや歌声を試せます。サーバーで音源IDを保存し、アレンジの方向性ごとにタスクを送信します。進捗を確認し、完成したバージョンをプレーヤーに渡します。

連携方法

項目

詳細

エンドポイント

POST /v1/song/remix

モデルパラメータ

model=mureka-9.5

音源の指定

purpose=remixで音源をアップロードしてupload_audio_idを取得するか、直近1か月にMurekaで生成した曲のsong_idを指定します。

長さ

10–480 s

1回の生成数

nは既定値2、最大3

料金

新バージョン:1曲あたり$0.5(旧バージョンのV8は1曲あたり$0.2のまま)。

ドキュメント

APIリファレンス

生成結果は原曲を再解釈したもので、原曲の歌手の声質は引き継がれません。特定の歌手の声質の指定や、スタイル参照用の追加音源のアップロードには現在対応していません。

モデルの指定:リクエストの 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リファレンス