はじめに
このエンドポイントの機能
動画の音声トラックから背景音楽を除去し、同じ動画を返します。映像は処理しません。
主な入力
唯一のフィールドは video_url です。最大 10 分の動画をアップロードするか直接リンクします。
返される結果
元のフレームサイズ、フレームレート、長さを維持し、音声から音楽を除去した MP4 を 1 本返します。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| エンドポイント | 動画編集 |
| 維持するもの | 会話、映像、長さ、フレームレート |
| 課金 | 元動画を秒単位、最低 3 秒分 |
主な機能とハイライト
ジャズを除去して会話を残す
上はジャズトリオを重ねた、ワインセラーでの 8 秒の会話音声です。下は出力です。連続した音楽の線が消え、話し声は保たれ、最後の発言後は無音になっています。
映像を変えずに返します
処理するのは音声のみです。1280×720 のフレーム、24 fps、長さはアップロード時と同じで、そのまま編集に戻せます。
会話を残し、曲を除去
話し声を残して音楽を取り除きたい場合に使います。音楽を別トラックで取り出したい場合は、音声ファイルの両方の成分を返す Vocal Isolator を使います。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 背景音楽を除去する最大 10 分の動画。MP4 か WebM をアップロードするか直接リンクします。 1 文字以上 |
料金
$0.0024 / 出力秒
元動画の長さを秒単位で切り上げ、最低 3 秒分を課金します。10 分を超える動画は送信時に拒否されます。失敗したリクエストは無料です。
ユースケース
ライセンス曲を含めずに再投稿
著作権のある音楽を動画から取り除き、話し声を残します。使用権のある音楽に差し替えて投稿できます。
編集した映像の音楽を差し替え
仮編集の音楽を完成版に差し替えます。会話の個別トラックに戻る必要はありません。
吹き替え用素材の準備
話し声を翻訳する前に背景音楽を除去し、新しい声の下に音楽を加え直します。
プロンプトガイドと実践のヒント
動画を送信します
最大 10 分の MP4 か WebM をアップロードするか、ファイルに直接リンクします。他の設定はありません。
タスクの完了を待ちます
テストでは 8 秒の動画に約 77 秒かかりました。長い動画ほど処理時間も長くなります。
新しい音声を加えます
処理後の音声に新しい音楽を重ねるか、動画を吹き替えツールへ送ります。映像が変わらないため、同期も保たれます。
はじめに
Video Music Remover は動画から背景音楽を除去して返します。会話を保ち、映像は変更しません。ライセンス曲の除去、仮の音楽の差し替え、吹き替え前の準備を手早く行えます。
リクエスト
{
"video_url": "https://example.com/vlog.mp4"
}
フィールドは video_url のみで、最大 10 分の動画に対応します。
テストで確認した結果
ワインセラーの 2 人の会話を写した 8 秒、1280×720 の動画に、声より約 4 dB 小さいジャズトリオを混ぜました。約 77 秒後、1280×720、24 fps で返りました。元のきれいな会話と比較すると、出力の音楽は検出できず、2 人の声は保たれ、最後の発言後もきれいな無音でした。
タスクの流れ
呼び出しは非同期です。タスクを作ったら完了するまで状態を確認し、仕上がった MP4 を SpicyAPI ストレージから取得します。元動画の長さに応じた秒単位の課金で、失敗したリクエストは無料です。
ヒント
- 歌声は音楽として扱うため、背景のボーカル曲も除去されます。
- 音楽を別ファイルで取り出す場合は、音声を抽出して Vocal Isolator (
/models/vocal-isolator-v1) を使います。 - 音楽がなくノイズの多い話し声には ElevenLabs Audio Isolation (
/models/elevenlabs-audio-isolation) が適しています。
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/music-remover-v1/video-edit",
"input": {
"video_url": "https://example.com/reference.mp4"
}
}'
# 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 リファレンスを参照してください。

