はじめに
このエンドポイントの役割
動画の主な被写体を、その後ろにあるものすべてから切り離します。グリーンバックも範囲指定も要りません。髪や毛並み、ゆったりした布は柔らかい輪郭のまま残ります。
重要な入力
video_url には 120 秒以内のクリップを 1 本渡します。output_format で結果を mp4、webm、matte から選びます。mp4 のときは background_image_url または background_video_url を追加できます。resolution は 480p か 720p です。
返ってくるもの
元の縦横比と長さを保ち、元の音声が入った動画 1 本です。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| エンドポイント | 動画編集 |
| 背景 | 指定した画像または動画(mp4 のみ)。指定なしは白 |
| 解像度 | 480p または 720p、元の縦横比を維持 |
| 料金 | 元の秒数 × 選んだ解像度の単価、最低 3 秒 |
主な機能とハイライト
海辺のテラスから街の屋上へ
海を見下ろすテラスに立つ女性の 5 秒のクリップに、夕暮れの屋上を映した動画を背景として渡しました。戻ってきた映像では女性が屋上に立ち、長い髪は束にならずに一本一本がほどけたまま、背後では景色が動き、元の音声もそのまま残っていました。静止画を渡しても同じように合成され、背景を何も渡さなければ白背景の MP4 になります。
自分で合成するための白黒マット
matte を選ぶと、被写体が白、それ以外が黒の MP4 が返ります。長さもフレームレートも元のクリップと同じです。ルマキーを扱える編集ソフトで元の映像と組み合わせて使ってください。
本物のアルファチャンネルを持つ WebM
webm を選ぶと背景が透明な VP9 ファイルになり、ゲーム画面やスライド、別のショットの上にそのまま重ねられます。Chrome、Edge、Firefox では透過して見えますが、Safari では同じファイルが黒背景で再生されます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 処理するクリップ。MP4 か WebM のアップロード、またはファイルへの直接リンクで、120 秒以内です。 1 文字以上 |
output_format | いいえ | mp4(既定)は被写体を指定した背景画像・背景動画、または白の上に返します。webm は透過付きの VP9 を返します(Safari では黒背景で表示)。 |
background_image_url | いいえ | 任意。被写体の後ろに置く JPEG・PNG・WebP で、画面いっぱいに拡大されます。 1 文字以上 |
background_video_url | いいえ | 任意。被写体の後ろに置く MP4・WebM で、画面いっぱいに拡大され、クリップより短ければループします。 1 文字以上 |
resolution | いいえ | 出力サイズ:480p または 720p(既定)。元の縦横比を保ちます。 |
料金
元のクリップの秒数に、選んだ解像度の秒単価をかけて請求します。秒は切り上げ、最低 3 秒です。120 秒を超えるクリップは受け付け時に拒否されます。出力形式と背景では料金は変わりません。失敗したリクエストは請求されません。
| 仕様 | 料金 |
|---|---|
| $0.024 / 秒 |
| $0.048 / 秒 |
ユースケース
トーク動画をブランドのセットの前に
普通の部屋で撮った話し手を、スタジオ風の静止画やループする映像背景の前に置けます。グリーンバックも撮り直しも要りません。
編集や配信用のオーバーレイ
ダンサーやペット、商品を透過 WebM にすれば、VP9 のアルファを読める編集ソフトでゲーム画面やスライド、別の映像の上に重ねられます。
合成用のキートラック
マット出力は、After Effects や DaVinci Resolve、Nuke のようなワークフローで元のクリップと組み合わせられる、白黒のきれいなトラックです。
プロンプトガイドと実践のヒント
被写体がはっきりしたクリップをアップロード
被写体は自動で検出されるので、プロンプトもクリックでの指定も不要です。カメラの前に人や物がひとつだけ映っている映像ほど、きれいに切り抜けます。クリップは最長 120 秒です。
受け取りたい形式を選ぶ
新しい背景での完成カットなら mp4、透過が必要なら webm、編集ソフトでキー用トラックを使うなら matte を選びます。背景画像と背景動画が使われるのは mp4 のときだけです。
480p で確認し、720p で仕上げる
どちらのサイズも元の縦横比を保ちます。720p の秒単価は 480p の 2 倍なので、まず短い 480p で切り抜きの具合を確かめるのがおすすめです。
はじめに
Video Background Remover Pro は普通のクリップを受け取り、カメラの前にいる人や物を見つけて、周りの景色から切り離します。返ってくる形は自分で決められます。新しい背景の上に置いた被写体、透過背景だけの被写体、または自分の編集ソフトでキーとして使う白黒のマットです。
リクエスト
{
"video_url": "https://example.com/beach.mp4",
"background_video_url": "https://example.com/city-lights.mp4",
"output_format": "mp4",
"resolution": "720p"
}
必須なのは video_url だけです。output_format の既定値は mp4、resolution は 720p です。background_image_url と background_video_url はどちらか一方だけを、mp4 のときにだけ送ってください。どちらもなければ被写体は白背景に置かれます。
3 つの出力
mp4:完成したカット。背景画像は画面いっぱいに拡大され、背景動画も同じように拡大されて、クリップより短ければループします。webm:アルファチャンネル付きの VP9。Chrome、Edge、Firefox では透過して表示され、Safari では黒背景で再生されます。matte:被写体が白、それ以外が黒の MP4 で、元の映像とフレーム単位でそろっています。
テストで確認したこと
低い夕日を背に、風で髪がなびく女性を写した 16:9、3 秒の海辺のクリップで試しました。480p ではどの出力も 854×480・24 fps、720p では 1280×720 で返り、処理には 1 本あたりおよそ 1〜2 分かかりました。横長の 2:1 のテラスのクリップは 906×452・25 fps で返りました。サイズは高さを固定するのではなく選んだ設定の画素数に合わせて決まり、フレームレートは元の映像のままです。マットでは細い髪の毛も分かれて残り、WebM は本物のアルファチャンネル付きでデコードでき、MP4 には元の音声が入っていました。2 秒のクリップは最低料金の 3 秒分で請求されました。
タスクの流れ
呼び出しは非同期です。タスクを作成し、完了するまでポーリングしてから、SpicyAPI のストレージから動画をダウンロードします。失敗したリクエストは請求されません。
ヒント
- 料金は元の長さで決まるので、必要な部分だけに切ってからアップロードしてください。
- 被写体がひとつに絞れる映像がいちばん向いています。画面に何人もいると、どれを被写体にするかはツールが判断します。
- Safari も含めたブラウザーで透過を見せたい場合は、WebM ではなくマットと元のクリップを組み合わせて使ってください。
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/background-remover-video-pro/video-edit",
"input": {
"output_format": "mp4",
"resolution": "720p",
"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 リファレンスを参照してください。



