はじめに
既存の録音を一度のリクエストでボーカルと背景音に分離します。二つのステムを音楽の練習、ナレーションの編集、新しいミックスに活用できます。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 音声 |
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
audio_url | はい | 分離するミックス済みの録音を音声 URL で指定します。アップロード欄は MP3 または WAV に対応しています。 1 文字以上 |
料金
$0.0012 / 秒
入力音声の秒数に対して一度だけ課金し、一秒単位で切り上げます。両方のステムが同じ時間分の料金に含まれます。このエンドポイントは 1～600 秒を受け付けます。
ユースケース
テキスト → audio-separation → 音声
audio-separation
音声
非同期ジョブ
プロンプトガイドと実践のヒント
はじめに
Vocal Isolator は、既存の音声録音をボーカルトラックと背景音トラックに分離します。ミックス済みの録音を audio_url で送信してください。プロンプトや、事前に生成した音楽のタスクは不要です。このエンドポイントは、楽曲のリハーサル、ナレーション付きクリップ、音楽が流れるポッドキャストの録音など、すでにある音声を扱うためのものです。
主な機能と特徴
一つの録音から二つのステム
このタスクは、同じ音源の両方の要素を返すことを想定しています。最初がボーカル、次が残りの背景音です。音楽では背景音は楽器の伴奏にあたります。話し声の録音では、音楽や環境音が含まれることもあります。これは一度の処理から得られる関連するステムであり、どちらかを選ぶ二種類の生成結果ではありません。分離後も音の混入が聞こえたり、両方の要素に重なる細部が失われたりする場合があります。
入力音声の長さで課金量が決まる
入力録音の長さに応じて、一秒単位で切り上げて課金します。二つのステムを受け取っても、課金対象の時間が二倍になることはありません。このエンドポイントは 1～600 秒の録音を受け付けます。出力の長さ、話者、出力コーデックを指定する設定はありません。元のミックスを両方の結果と一緒に保管しておけば、出発点となった録音を失うことなく分離結果を比較できます。
活用例
音楽の練習用トラックを準備する
背景音のステムを自分用の伴奏として練習し、ボーカルのステムはフレージングの確認用に保管します。音量の大きい部分だけでなく、音の途切れる部分も聴いてください。残響やバックコーラスが伴奏に残ることがあります。ステムが練習に適しているか判断する前に、同程度の再生音量で比較してください。
既存のミックスからナレーションを分離する
音楽に話し声を重ねたクリップでは、ボーカルの結果を新しい編集に配置する前に試聴してください。背景音のステムは編集の参考になることがありますが、音楽だけが含まれるとは限りません。エディターで比較するときは、両方のステムの開始位置を同じ元音源の開始位置に合わせてください。
プロンプトのガイドと活用のコツ
元の録音を準備する
調整するプロンプトはありません。スピーカー再生を録音したものや、さらに圧縮したコピーではなく、手元にあるミックス済み録音のうち最も明瞭なものをアップロードしてください。アップロード欄では MP3 または WAV を使ってください。このエンドポイントは、渡されたファイル全体を処理します。長い録音の一部だけが必要な場合は、先に別の音源クリップを用意してください。元の録音を保管し、分離した各ステムには別々の名前を付けてください。
使う前に両方のトラックを確認する
話し声の子音、伸ばした音、フレーズ間の無音、左右のチャンネルを確認してください。ボーカルに楽器などの音が混入していないか、背景音に声が残っていないかを聴き取ってください。ステムを再び足し合わせれば元の録音が完全に再現されるとは考えないでください。長いシーケンスを編集する前に実際の長さを測り、使用するエディターで時間的な整合性を確認してください。出力形式、サンプルレート、分離品質は、引き続き実際に使う素材での検証が必要です。
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": "spicyapi/vocal-isolator-v1/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 リファレンスを参照してください。