Object Eraser API リファレンス
名前やブラシで指定して何でも消去、跡も自然に
PopNow の API キー 1 つで、Object Eraser を自分のコードから呼び出せます。送るモデル ID、受け付ける入力フィールド、1 回あたりのクレジット、ターミナルに貼ってそのまま動くリクエストをこのページにまとめました。
パラメーターの説明はモデルの入力 schema から取っているため、英語のみです。
概要
- 開発元
- PopNow
- 出力
- 画像
- 最安
- 4.5 クレジット 画像 1 枚あたり ($0.045)
- 目安の所要時間
- 約 36 秒
1 クレジット = 0.01 米ドル。タスクの受付時に上限額を確保し、完了時に実際の使用量で精算します（整数クレジットに切り上げ、差額は返却）。失敗したタスクには課金されません。実行前に正確な金額を知りたいときは POST /api/v1/jobs/quote を呼んでください。
物を消す
popnow/object-eraser-v1/edit
料金
| オプション | クレジット (画像 1 枚あたり) | 米ドル |
|---|---|---|
既定 | 4.5 | $0.045 |
パラメーター
| フィールド | 型 | 既定値 | 指定できる値 | 説明 |
|---|---|---|---|---|
image_url必須 | string | — | — | Photo to clean up. The selected objects are removed and the space is filled to match the scene. |
prompt任意 | string | — | 1,000 文字まで | What to remove, in a few plain words with a position when there is more than one, e.g. "the wooden bench on the left". Give this, mask_url, or both. |
mask_url任意 | string | — | — | Optional black-and-white mask the same size as the photo: white marks what to remove, black what to keep. Give this, prompt, or both. |
output_format任意 | string | png | png, jpeg, webp | File format of the returned image. |
リクエスト例
このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 POPNOW_API_KEY に設定してください。
例の image_url には PopNow のサンプル素材を使っています。自分の公開 HTTPS リンク、アップロードしたファイル、保存済みアセットに置き換えてください。
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/object-eraser-v1/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"
}
}'レスポンスにはすぐに taskId が入ります。結果は GET /api/v1/jobs/recordInfo で取得するか、callBackUrl を付けて通知を受け取ります。
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"