Face Swap API：料金・パラメーター・コード

Name: Face Swap API
SKU: popnow/face-swap-v1/edit
Price: 0.02 USD
Availability: InStock

リクエストパラメーター

パラメーター	必須	説明
`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.
`image_url`	はい	出発点になる画像。
`reference_image_url`	はい	Reference face image. The facial features from this image are transferred onto the target.
`seed`	いいえ	同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647
`style`	いいえ	あらかじめ用意されたスタイルやジャンル。 realistic · beautify · lossless · デフォルト: realistic

料金

料金はクレジットで表示され、サイトで使うクレジットと同じです（1クレジット = $0.01）。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。

オプション	クレジット /枚	≈ USD
標準	1.95	$0.02

タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 2クレジット/枚（$0.02）です。

実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。

API クイックスタート

Face Swap API を 3 ステップで呼び出す

API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
リクエストを送る. POST /jobs/createTask に、model を popnow/face-swap-v1/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-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "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 タブにレスポンス、ポーリング、コールバックのリファレンスがあります。

Face Swap API についての質問

Face Swap API の料金はいくらですか？

Face Swapは2クレジット（$0.02）/枚です。クレジットはサイトと共通（1クレジット = $0.01）で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。

API でのFace Swapのモデル名は？

POST /jobs/createTask の model フィールドに顔の入れ替えは popnow/face-swap-v1/edit を指定します。

Face Swap と Head Swap は何が違いますか？

Face Swap は顔立ちだけを移し、対象側の髪型と頭の形を残します。Head Swap は髪とシルエットを含めて頭部ごと差し替えます。髪を変えるべきかどうかで選んでください。

image_url にはどちらの画像を入れますか？

書き換えられる側です。顔を供給するのは reference_image_url です。この 2 つは入れ替えられず、逆にしたリクエストも妥当なのでエラーは出ないまま、まったく別の結果になります。

prompt やマスクはありますか？

ありません。スキーマは image_url、reference_image_url、seed の 3 つです。書く文言も塗る領域もないので、曖昧な指示に起因する失敗が丸ごと消えます。

どんな入力写真が向いていますか？

はっきり見えていて、ある程度正面を向き、光の当たった、画面内で十分な大きさの顔です。2 枚で光の向きが揃っていれば理想的です。横顔、手ぶれ、強い遮蔽、小さすぎる顔では劣化します。

1 枚に複数の顔があっても処理できますか？

できません。1 枚につき顔は 1 つという前提で動きます。集合写真では、どの人物を指しているのか伝える手段がありません。送る前に被写体を切り抜いてください。

コードを書かずにFace Swapを試せますか？

はい。Playground なら API キーなしで、PopNow のクレジットでFace Swapを実行でき、実行ごとに対応するコードが表示されます。

すべての Face Swap モデル

Face Swap についてさらに

試す: Face Swap のAI顔入れ替えをオンラインで PopNow で Face Swap を使って画像を作る
ドキュメント: API ドキュメントの Face Swap モデル ID と入力スキーマ PopNow API クイックスタート：5 分で最初のリクエスト PopNow API 画像生成ガイド Webhook：ポーリングせずに Face Swap の結果を受け取る