リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
face_enhance | いいえ | Run a face-enhancement pass on the swapped face for a sharper, more detailed result. デフォルト: false |
face_mapping | いいえ | Multi-person swap: which face in the reference image goes onto which face in the target, one entry per face. Faces are numbered from 0 in detection order. |
reference_image_url | はい | Reference face image. The facial features from this image are carried onto the person in the video. |
style | いいえ | あらかじめ用意されたスタイルやジャンル。 realistic · beautify · lossless · デフォルト: realistic |
video_url | はい | 加工する動画。 |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです（1クレジット = $0.01）。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /秒 | ≈ USD |
|---|---|---|
| 標準 | 3.9 | $0.039 |
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
Video Face Swap API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を popnow/face-swap-video-v1/video-edit、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/face-swap-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
"style": "realistic"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
Video Face Swap API についての質問
Video Face Swap API の料金はいくらですか？
Video Face Swapは3.9クレジット（$0.039）/秒です。クレジットはサイトと共通（1クレジット = $0.01）で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのVideo Face Swapのモデル名は？
POST /jobs/createTask の model フィールドに 動画の顔入れ替えは popnow/face-swap-video-v1/video-edit を指定します。
Face Swap とは何が違いますか？
Face Swap が変更するのは静止画です。Video Face Swap は同じ種類の顔立ちの移し替えを、クリップ全体にわたってフレームごとに行います。参考の顔はどちらも静止画です。
どの入力に何を入れますか？
video_url には変更する動画、reference_image_url には顔を提供する写真を入れます。一方は映像、もう一方は静止画なので、うっかり取り違えることはありません。
prompt、マスク、seed はありますか？
ありません。スキーマは video_url、reference_image_url と任意の style だけです。言い回しを考える必要も領域を塗る必要もないため、指示があいまいなことによる失敗がまるごとなくなります。
style はどれを選べばよいですか？
まず既定の realistic から始めてください。自然な肌の色と質感を保ちます。beautify は肌をなめらかに明るく整えます。lossless は参考画像の顔のディテールを最大限に残し、クローズアップに向いています。
どんな映像が向いていますか？
画面に 1 人だけが映り、顔が十分な大きさで、光が均一で、長い時間カメラから顔をそらさない映像です。大きく横を向いた顔、速い動きによるブレ、顔にかかる手、小さすぎる顔では品質が落ちます。
コードを書かずにVideo Face Swapを試せますか？
はい。Playground なら API キーなしで、PopNow のクレジットでVideo Face Swapを実行でき、実行ごとに対応するコードが表示されます。
