はじめに
既存のクリップから前景を切り抜き、透明または単色の背景を選べます。デフォルトでは、元の音声付きの透明な WebM VP9 をリクエストします。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 1~60 秒のソースクリップ。出力では検出された前景を切り抜きます。 1 文字以上 |
background | いいえ | 透明または十種類の単色から選択します。透明な出力にはアルファ対応の形式が必要です。 |
output_format | いいえ | コンテナーとコーデックのプリセット。デフォルトは WebM VP9 です。 |
keep_original_audio | いいえ | 出力に元の音声を含めるようリクエストします。デフォルトで有効です。 デフォルト値: |
料金
$0.06 / 秒
入力動画の秒数に応じて、秒未満を切り上げて課金します。このエンドポイントは 1~60 秒のクリップを受け付けます。背景、形式、音声の選択によって、この時長に基づくルールは変わりません。
ユースケース
動画 → 動画編集 → 動画
動画編集
動画
非同期ジョブ
プロンプトガイドと実践のヒント
はじめに
動画背景除去は、既存の動画から前景を切り抜き、合成や単色の背景への配置に使えるようにします。video_url を送信し、背景と書き出し形式を選択してください。デフォルトのリクエストでは透明な WebM VP9 を指定し、元の音声を保持します。このエンドポイントは 1~60 秒のソースクリップを受け付けます。プロンプトから新しいシーンを生成するものではありません。
主な機能と特長
背景と形式を選んで透明にする
background を transparent に設定し、アルファ対応の形式を使用してください。WebM VP9、MOV ProRes 4444、MKV VP9、GIF は、仕様上アルファ対応の選択肢です。このエンドポイントでは、MP4 プリセットと MKV H.264 または H.265 のプリセットにアルファは含まれません。互換性のない透明出力のリクエストは拒否される場合があります。MOV H.265 は仕様上の対応が部分的なため、標準的な透明出力のワークフローでは WebM VP9 を使い、合成前に実際の出力を確認してください。
単色と元の音声
背景には黒、白、グレー、赤、緑、青、黄、シアン、マゼンタ、オレンジも選べます。keep_original_audio は、結果に元の音声を含めるようリクエストするかどうかを制御します。GIF に音声トラックは含められないため、選ぶ場合は音声の保持をオフにしてください。コンテナー、コーデック、背景の選択によって、時長に基づく課金ルールは変わりません。課金には入力の秒数を切り上げて使用します。このエンドポイントにクロップや出力解像度の指定機能はありません。
活用例
プレゼンテーションに発表者を重ねる
発表者と背景がはっきり分かれている短いクリップから始めてください。透明な WebM VP9 をリクエストし、その形式に対応したエディターで、結果をスライドやシーンの上に配置します。合成映像を公開する前に、暗い背景と明るい背景の両方で、髪や動きでぼけた輪郭を確認してください。
新しいレイアウト用に商品クリップを準備する
商品を元の環境から切り抜き、カタログのレイアウトやソーシャルメディア用の編集に映像を再利用できます。透明にする必要がない場合は、単色での書き出しが便利です。反射面や細かな輪郭は入念に確認してください。結果は処理済みのマスクなので、市松模様のプレビューだけでなく、実際に使用する背景上で評価する必要があります。
プロンプトガイドと活用のヒント
用途に合わせて納品形式を選ぶ
標準的な動画ワークフローでは、background=transparent、output_format=webm_vp9、keep_original_audio=true を維持してください。別のプリセットを選ぶのは、使用するエディターで読み込めることを確認してからにしてください。ウェブ上での再生対応はブラウザーとコーデックによって異なります。ダウンロードに成功しても、埋め込みプレビューやその後の編集が機能するとは限りません。共有用に透明度を統合した別のプレビューを作る場合も、透明なマスターは保存してください。
透明度とクリップ全体を検証する
実際のアルファチャンネルを確認し、結果を黒、白、彩度の高い色の上に合成してください。ファイルに市松模様や黒い長方形が表示されるだけでは、透明度が機能している証拠にはなりません。動きの全体を見て輪郭の変化を確認し、時長、フレームの寸法、音声の同期を元の動画と比較してください。ファイル名や選択したオプションからアルファの有無を判断しないでください。この連携では、メディア品質やブラウザー互換性の試験はまだ完了していません。実際に使用するワークフローで結果を検証してください。
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-v1/video-edit",
"input": {
"background": "transparent",
"output_format": "webm_vp9",
"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 リファレンスを参照してください。
