はじめに
このエンドポイントの役割
ミックス済みの曲を 1 つ受け取り、5 本のステムに分けて、それぞれを個別の WAV ファイルで返します。
重要な入力
入力は audio_url だけです。10 分までの MP3 か M4A の曲を指定します。
返ってくるもの
音声アセットが 5 つ返り、それぞれの stem フィールドに vocals、instrumental、drums、bass、other のいずれかが入ります。
| 項目 | 値 |
|---|---|
| 入力 | 音声 |
| 出力 | 音声 |
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
audio_url | はい | 分離する曲。MP3 のアップロード、または MP3・M4A ファイルへの直接リンクで、10 分までです。 1 文字以上 |
料金
$0.108 / 曲
長さにかかわらず 1 曲ごとの定額で、10 分の曲まで対応します。5 本のステムすべてが含まれます。失敗したリクエストは請求されません。
ユースケース
プロンプトガイドと実践のヒント
はじめに
Mureka Stem Separation は、AI 音楽の会社 Mureka のステム分離です。ミックスが終わった曲を渡すと、パートごとに分けて返します。リードとコーラスの声が 1 本、伴奏全体が 1 本、さらにその伴奏をドラム、ベース、それ以外に分けたものです。
リクエスト
{
"audio_url": "https://example.com/song.mp3"
}
曲は MP3 か M4A のファイルにしてください。WAV や FLAC などの形式は送信時に拒否されます。
返ってくるもの
タスクはステムごとに 1 つ、計 5 つの音声アセットを返し、それぞれに stem フィールドが付きます。
| stem | 内容 |
|---|---|
vocals | リードとコーラスの声 |
instrumental | 声以外のすべて |
drums | 伴奏のうち打楽器 |
bass | 伴奏のうちベースライン |
other | 伴奏の残り:ギター、鍵盤、パッド、効果音 |
どのステムも 16 ビット・44.1 kHz・ステレオの WAV で、長さは曲とぴったり同じです。どの編集ソフトでも 5 本が最初のサンプルからそろいます。
テストで確認したこと
60 秒のボサノバのデュエットと、同じ曲の 30 秒の抜粋を分離しました。どちらもおよそ 10 秒以内に終わりました。ドラム・ベース・その他を足すと、インストとサンプル単位で一致しました。伴奏だけの区間ではボーカルのステムはほぼ無音で、歌の部分より約 55 dB 低く、バンドの音はほとんど混ざっていませんでした。60 秒の WAV 1 本は約 10.6 MB でした。
タスクの流れ
呼び出しは非同期です。タスクを作成し、完了するまでポーリングしてから、SpicyAPI のストレージから各ステムをダウンロードします。失敗したリクエストは請求されません。
ヒント
- 手元でいちばん音質のよいファイルから始めてください。強く圧縮された MP3 のノイズはすべてのステムに残ります。
- カラオケ音源には
instrumentalを使います。ドラムの音を差し替えてミックスし直すならvocals、bass、otherを使います。 - ステムは非圧縮なので、3 分の曲なら合計で約 160 MB の音声になります。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "mureka/stem-separation/audio-separation",
"input": {
"audio_url": "https://example.com/reference.mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。

