PopNowAPI ドキュメント
本文

Face Swap Plus API リファレンス

肌の色を自動で合わせる顔の入れ替え

PopNow の API キー 1 つで、Face Swap Plus を自分のコードから呼び出せます。送るモデル ID、受け付ける入力フィールド、1 回あたりのクレジット、ターミナルに貼ってそのまま動くリクエストをこのページにまとめました。

パラメーターの説明はモデルの入力 schema から取っているため、英語のみです。

概要

開発元
PopNow
出力
画像
最安
24 クレジット 画像 1 枚あたり ($0.24)
目安の所要時間
約 31 秒
モデル ID

1 クレジット = 0.01 米ドル。タスクの受付時に上限額を確保し、完了時に実際の使用量で精算します（整数クレジットに切り上げ、差額は返却）。失敗したタスクには課金されません。実行前に正確な金額を知りたいときは POST /api/v1/jobs/quote を呼んでください。

顔の入れ替え

popnow/face-swap-v1-plus/edit

料金

オプションクレジット (画像 1 枚あたり)米ドル
既定24$0.24

パラメーター

フィールド型既定値指定できる値説明
image_url必須string——Target image. The face of the person in this image is the one that gets replaced.
reference_image_url必須string——Reference face image. The facial identity from this image is transferred onto the target.
prompt任意string—200 文字までOptional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle.
output_format任意stringjpegpng, jpeg, webpFile format of the returned image.
output_quality任意integer9510〜100Requested image quality for the result, from 10 to 100.
seed任意integer—0〜2147483647Random seed; reuse it to keep two runs over the same image pair comparable.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 POPNOW_API_KEY に設定してください。

例の image_url, reference_image_url には PopNow のサンプル素材を使っています。自分の公開 HTTPS リンク、アップロードしたファイル、保存済みアセットに置き換えてください。

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "popnow/face-swap-v1-plus/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp"
  }
}'

レスポンスにはすぐに taskId が入ります。結果は GET /api/v1/jobs/recordInfo で取得するか、callBackUrl を付けて通知を受け取ります。

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

次に読む

このページの内容

概要顔の入れ替え次に読む