はじめに
非同期 video-edit に video_url、edit_target と、prompt または reference_image_url を送ります。change と background では対象の役割が逆になり、出力尺の指定はありません。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| 提供元 | ComfyUI |
| エンドポイント | video-edit |
| 元動画 | 連続映像、最大 15 秒 |
| 解像度 | 480p / 540p / 768p が既定 / 1080p |
| 音声 | 入力の音声トラックを保持 |
| 実行方式 | 非同期タスク、入力尺に応じた課金 |
主な機能とハイライト
髪色と髪の長さを別々に確かめます
温室のテストでは短いプラチナブロンドを指定しました。色は変わりましたが、元のカールと長さは多く残っています。色が希望に近くても、髪型まで指定どおりになったとは限らないため、属性ごとに確認してください。
対象の隣にいる人も見比べます
酒蔵のテストでは blouse を対象に、白いリネンシャツを指定しています。女性の衣服だけでなく、隣の男性や掲げたグラスも見比べてください。選択外の全ピクセルが一致すると考えず、衣装の変更範囲を確認するための比較です。
背景変更では残す対象を指定します
background モードでは people を残す対象にして、プロンプトに夜の屋上テラスを記述します。酒蔵の例では 2 人とグラスを残し、周囲を街明かりのある景色に変えています。人物の輪郭や腕の周囲など、元の背景と新しい背景の境界を確認してください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 必須の連続動画で、最長 15 秒です。切り返しは使えません。 1 文字以上 |
edit_target | はい | hair、jacket、car など、画面内の要素を短く指定します。複数はカンマで区切り、background では残す要素になります。 1 文字以上 · 120 文字以内 |
edit_mode | いいえ | 既定は change で対象を置換します。background は対象を残して周囲を変えます。 |
prompt | いいえ | 変化後の見た目を記述します。background なら新しい場所です。 600 文字以内 |
reference_image_url | いいえ | 服、髪型、商品、場所の任意の参照画像です。単品画像と文章の併用を勧めます。 1 文字以上 |
resolution | いいえ | 480p、540p、768p(既定)、1080p です。上位は秒単価が高く、横長の実測値は 864×480、960×544、1376×768、1920×1056 でした。 |
seed | いいえ | seed は任意で指定でき、整数の範囲は 0〜2147483647 です。同じ乱数源で設定を一つずつ比較できますが、同じフレームを再現する保証はありません。 |
料金
物件編集は入力尺を秒単位で切り上げ、最低 3 秒として計算します。選択解像度で単価が変わり、画像の別料金はありません。失敗は課金せず、15 秒超は課金する前に拒否します。
| 仕様 | 料金 |
|---|---|
| $0.105 / 秒 |
| $0.119 / 秒 |
| $0.14 / 秒 |
| $0.28 / 秒 |
ユースケース
衣装案の検討
許可を得た成人の映像で革のジャケットや麻のシャツを試せます。
髪色の比較
プラチナ色を試し、元の長さやカールが残っていないか確認できます。
乾杯の場所替え
人物とグラスを残し、酒蔵を夜の屋上に変えられます。
商品の差し替え案
単品画像と説明で商品の変更を試し、広告への採用前に仕上がりを確認できます。
プロンプトガイドと実践のヒント
編集の許可を確かめます
写真や動画と顔の利用許可を確認します。登場人物は全員 18 歳以上である必要があります。
対象とモードを選びます
edit_targetに外見に合う短い語を入力します。change は置換、background は対象を残す指定です。仕上がりを伝えます
prompt または
reference_image_urlを指定します。背景なら新しい場所を書き、衣服なら単品画像と文章の併用を勧めます。編集箇所を見直します
短い素材で実行し、完了した映像の対象、周囲の細部、音声を確認します。
概要
非同期 video-edit に video_url、edit_target と、prompt または reference_image_url を送ります。change と background では対象の役割が逆になり、出力尺の指定はありません。
処理の流れ
openjutsu/object-swap/video-edit を呼び出してタスク識別子を保存します。完了状態までポーリングし、成功した場合は結果アセットから編集動画を取得します。タイムラインへの配置前に動画を確認してください。
パラメータ
video_url: 必須の連続動画で、最長 15 秒です。切り返しは使えません。入力尺で課金され、元音声を保持します。edit_target: hair、jacket、car など、画面内の要素を短く指定します。複数はカンマで区切り、background では残す要素になります。edit_mode: 既定は change で対象を置換します。background は対象を残して周囲を変えます。人物を残すなら people を指定します。- prompt: 変化後の見た目を記述します。background なら新しい場所です。
reference_image_urlと少なくとも一方を指定し、併用もできます。 reference_image_url: 服、髪型、商品、場所の任意の参照画像です。単品画像と文章の併用を勧めます。人物全体の画像では衣服の再現に失敗した例があります。- resolution: 480p、540p、768p(既定)、1080p です。上位は秒単価が高く、横長の実測値は 864×480、960×544、1376×768、1920×1056 でした。
- seed: seed は任意で指定でき、整数の範囲は 0〜2147483647 です。同じ乱数源で設定を一つずつ比較できますが、同じフレームを再現する保証はありません。
料金
物件編集は入力尺を秒単位で切り上げ、最低 3 秒として計算します。選択解像度で単価が変わり、画像の別料金はありません。失敗は課金せず、15 秒超は課金する前に拒否します。
使い方のヒント
元の要素と変更後の姿を別々に書きます。参照は単品画像と文章を勧めます。別の長さの動画で汎用エラーになる場合は、整数秒の長さに切ってから試してください。
制約
- 物件の編集でも本人または同意した成人の顔だけを使ってください。有名人、知人、ネットの画像も公開されているだけでは利用できません。なりすましや誤認させる使い方は禁止です。
- 入力は最大 15 秒のワンカットに限定されます。複数ショットをつないだ素材は分割してから送信してください。
- 髪の試行ではプラチナ色に変わりましたが、短くする指定に対して元の長さとカールが残りました。色は形より変わりやすい場合があります。
- 人物全体の参照画像だけを使った衣装変更は意図に合いませんでした。単品画像と明確な文章を勧めますが、成功を保証する検証結果ではありません。
- 物件編集では、約 5.17 秒(5.13~5.20 秒)の素材の冒頭から約 4 フレームを自動で取り除き、処理する長さを正確に 5 秒にします。手動での切り取りは不要です。5 秒分だけを課金し、受理時に仮押さえした 6 秒分のうち余分な 1 秒分は返還されます。別の長さの素材で汎用エラーによる失敗が起きたら、整数秒ちょうどに切って再送してください。物件編集に失敗した場合の料金はかかりません。
本人か許可を得た人の顔だけをアップロードし、すべての素材で全員が 18 歳以上であることを確認してください。公開画像も利用許可ではなく、なりすましや他人を誤認させる利用はできません。ウェブでは初回実行前に同意欄のチェックが必須で、API 利用も同じ規則の受諾を意味します。違反内容は削除され、アカウント停止の対象となる場合があります。
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": "comfyui/openjutsu-object-swap/video-edit",
"input": {
"edit_mode": "change",
"edit_target": "example",
"resolution": "768p",
"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 リファレンスを参照してください。




