はじめに
MiniMax H3 Character Swap Video edit は、短いクリップの中の 1 人を、1 枚の画像のキャラクターに置き換えます。
主な機能とハイライト
- 動画、キャラクター画像、置き換える人物を送ります。プラットフォームは、アダプターが学習された指示を組み立てます（“Replace ... with the character in the picture; keep the reference character's face, hair and clothing; follow the source performance's pose, gaze, expression and movement; preserve the scene and the other people”）。
- Character Swap V1.5 アダプターは強度 1 で読み込まれます。
- アダプターを使うと、差し替えは元の動きに一拍ずつ従いました。アダプターなしの同じベースモデルでは、途中で演技を失い、一度は元の男性が通行人として画面に残ってしまいました。
- 二人の人物が映るカットでは、指名された人物だけが変わりました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | 元のクリップ（MP4）。最大 15 秒が使われます。 1 文字以上 |
image_url | はい | 新しいキャラクターの画像 1 枚。写真、3D レンダー、イラストのいずれも可。 1 文字以上 |
prompt | いいえ | 置き換える人物を数語で指定します（「左の女性」「白いシャツの男性」など）。空欄にすると主役が対象になります。 300 文字以内 |
aspect_ratio | いいえ | 出力の形（既定は 16:9）。元クリップと同じ形を選んでください。 |
resolution | いいえ | 480p（既定）、540p、768p、1080p。上位の解像度ほど秒あたりの料金が高くなります。 |
duration_seconds | いいえ | 出力の長さは 3〜15 秒（既定は 5）。演技全体が使われるよう、元クリップの長さに合わせてください。 |
seed | いいえ | 一度に 1 つの入力だけを変えながら、実行結果を比較しやすくします。フレーム単位で同一のクリップになることは保証しません。 |
料金
出力の秒数に加えて、元動画の秒数（開始した各秒が数えられ、最大 15 秒）と、キャラクター画像の小さな料金に応じて課金されます。料金は解像度によって変わります。
| 仕様 | 料金 |
|---|---|
| $0.06 / 秒 |
| $0.09 / 秒 |
| $0.12 / 秒 |
| $0.24 / 秒 |
ユースケース
- 出演同意書に署名した出演者を、同じテイクで別のルックに差し替える。
- 自分で生成した架空のキャラクターを、自分で撮影した実写映像に入れる。
- 撮り直しの前に、衣装やキャスティングの案をすばやくプレビューする。
プロンプトガイドと実践のヒント
- 描かれたキャラクターや 3D アニメのキャラクターを参照にすると、同じ髪、色、衣装の実在の人物として出てきます。
- 一部の実行では元の衣装が残ったり、参照の顔からずれたり、背景のエキストラが増えたりします。別の seed や別のクリップで再実行してください。
- 使用してよいのは、処理する許可を得た映像と肖像に限ります。自分自身、署名済みの出演同意書を持つ出演者、または生成した架空の人物などです。実在する人物を親密または名誉毀損的な映像に入れること、誰かになりすますこと、未成年が写る映像に使うことは、いずれも行わないでください。本人の明示的で十分な説明を受けた同意がない限り、実在の人物をそうした映像に入れてはいけません。写真が公開されていることは同意にあたらず、同意はプロジェクトをまたいで引き継げません。
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": "minimax/h3-character-swap/video-edit",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "480p",
"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 リファレンスを参照してください。
