はじめに
非同期の video-edit に MP4 と 1〜4 枚の人物画像を送ります。prompt は画像と人物の対応を指定します。出力尺や縦横比を指定する公開フィールドはありません。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| 提供元 | ComfyUI |
| エンドポイント | video-edit |
| 元動画 | 単一ショット、最長 15 秒 |
| 解像度 | 480p / 540p / 768p(既定)/ 1080p |
| 音声 | 元動画の音声を維持 |
| 実行方式 | 非同期、元動画の秒数で課金 |
主な機能とハイライト
画像の順番を役割指定に生かします
2 人の自転車走行テストでは、1 枚目を左の青いシャツの人、2 枚目を右の赤いシャツの人に割り当てています。画像と同じ順番で、人物の説明をプロンプトの別々の行に書きます。画面全体の変化だけで判断せず、各人物が指定どおりかを個別に確かめてください。
顔だけでなく全身の輪郭を見ます
スタジオのテストでは、実写の成人ダンサーを赤髪の漫画風ヒロインに置き換えています。元のポーズを動きの手掛かりに、髪や衣装が全身にわたって変わります。動作中の袖、腰回り、髪も見て、顔の仕上がりだけで全身の再現を判断しないでください。
短い映像の終わりまで確かめます
同じ 2 人の自転車走行テストを 3 秒時点で再び比較します。人物だけでなく自転車、間隔、街路を確認し、最後まで再生してください。この 5 秒の元映像に対する結果は約 4.5 秒でした。同じ長さに見せるためにプレビューを引き延ばさず、実際の出力時間を基準に編集します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 必須の MP4 です。15 秒以内で切り返しがなく、対象者が最初のフレームに見える素材を指定します。 1 文字以上 |
reference_image_urls | はい | 必須の配列で 1〜4 枚です。写真、イラスト、3D レンダリングを 1 人につき 1 枚使い、全身画像を推奨します。 1 件以上 · 4 件以内 |
prompt | いいえ | 任意です。画像と同じ順に 1 行につき 1 人、外見や位置で対象を指定します。 600 文字以内 |
resolution | いいえ | 480p、540p、768p、1080p から選びます。既定は 768p です。 |
seed | いいえ | 任意の 0〜2147483647 の整数です。同じ乱数源で一度に一つの入力を変えて比較できますが、フレーム単位の一致は保証しません。 |
料金
人物置換は元動画の秒数を整数に切り上げ、最低 3 秒分を課金します。解像度で単価が変わり、参照画像は追加課金されません。失敗は無料で、15 秒超の素材は課金前に拒否します。
| 仕様 | 料金 |
|---|---|
| $0.105 / 秒 |
| $0.119 / 秒 |
| $0.14 / 秒 |
| $0.28 / 秒 |
ユースケース
短編の配役案
許可を得た俳優の演技で、別のキャラクターを検討できます。
複数人の再配役
自転車で走る 2 人に別々の画像を割り当て、街並みを生かせます。
イラストからの出演
漫画や 3D のキャラクターを成人の演技映像に反映できます。
広告や投稿の比較
同じカメラワークで架空の登場人物を比較できます。
プロンプトガイドと実践のヒント
素材の使用許可を確認します
映像と容姿の使用権を確認し、登場人物が全員 18 歳以上であることを確かめます。自分、許諾書のある俳優、自作の架空キャラクターを使います。
画像と対象者をそろえます
全身が分かる画像を 1〜4 枚用意し、同じ順番で 1 行につき 1 人の対象を書きます。
結果の配役を確認します
解像度を選んで実行し、完了後に顔、衣装、動作、長さを確認してから公開します。
概要
非同期の video-edit に MP4 と 1〜4 枚の人物画像を送ります。prompt は画像と人物の対応を指定します。出力尺や縦横比を指定する公開フィールドはありません。
処理の流れ
openjutsu/character-swap/video-edit に送信し、返されたタスク ID を保存します。成功または失敗まで状態をポーリングし、成功したタスクの結果アセットから動画を取得します。元音声を維持し、実測の処理時間は約 1〜4 分です。
パラメータ
video_url: 必須の MP4 です。15 秒以内で切り返しがなく、対象者が最初のフレームに見える素材を指定します。reference_image_urls: 必須の配列で 1〜4 枚です。写真、イラスト、3D レンダリングを 1 人につき 1 枚使い、全身画像を推奨します。- prompt: 任意です。画像と同じ順に 1 行につき 1 人、外見や位置で対象を指定します。未指定なら 1 枚は主要人物、複数枚は登場順、同時なら左から右です。対象不明の画像は無視され、指定外の人物は残ります。
- resolution: 480p、540p、768p、1080p から選びます。既定は 768p です。上位ほど秒単価が上がり、横長の実測値は 864×480、960×544、1376×768、1920×1056 です。
- seed: 任意の 0〜2147483647 の整数です。同じ乱数源で一度に一つの入力を変えて比較できますが、フレーム単位の一致は保証しません。
料金
人物置換は元動画の秒数を整数に切り上げ、最低 3 秒分を課金します。解像度で単価が変わり、参照画像は追加課金されません。失敗は無料で、15 秒超の素材は課金前に拒否します。
使い方のヒント
人物の対応が曖昧なら全身画像と明示的な対象行を使います。それ以外の長さで汎用エラーが出たら整数秒に切って再試行し、結果の衣装も参照画像と比較してください。
制約
- 本人または同意を得た成人だけを使用してください。有名人、知人、ネット上の写真にも許可が必要です。実在の人物を、本人が同意していない場面に登場させないでください。
- 元動画は 15 秒以内の連続した MP4 に限ります。切り返しのある編集映像には対応せず、対象者は冒頭に見えている必要があります。
- 衣装は参照画像どおりになるとは限りません。成人女性の写真を使った試行では、画像と異なる白いロングドレスになりました。
- 人物置換では、約 5.17 秒(5.13~5.20 秒)の元動画は処理前に冒頭の約 4 フレームが自動で除かれ、ちょうど 5 秒になります。自分で切る必要はなく、料金は 5 秒分です。6 秒分の仮押さえとの差額である 1 秒分は返還されます。それ以外の長さで汎用エラーにより失敗した場合は、整数秒ちょうどに切って再試行してください。人物置換の失敗分は課金されません。
- 実測では 5 秒の素材が約 4.5 秒になり、8 秒の素材は 8 秒でした。納品前に尺を確認してください。
自分の顔か同意を得た人の顔だけを使い、すべての素材の登場人物を 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-character-swap/video-edit",
"input": {
"reference_image_urls": [
"https://example.com/reference.png"
],
"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 リファレンスを参照してください。




