요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 출발점이 되는 이미지. |
mask_url | 아니요 | 바꿀 영역을 칠합니다. |
output_format | 아니요 | 결과 파일 형식. png · jpeg · webp · 기본값: png |
prompt | 아니요 | 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". |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 4.5 | US$0.045 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 5크레딧/장(US$0.05)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Object Eraser API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/object-eraser-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/object-eraser-v1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "png"
}
}'
# 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 탭에 있어요.
Object Eraser API 질문
Object Eraser API 요금은 얼마인가요?
Object Eraser 가격은 5크레딧(US$0.05) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Object Eraser의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 AI 지우개: popnow/object-eraser-v1/edit을(를) 넣으세요.
마스크가 꼭 필요한가요?
항상 그렇지는 않습니다. 주변에 여백이 있는 뚜렷한 물건이라면 짧은 설명만으로 지워집니다. 테스트에서는 나무 국자가 설명만으로 지워졌습니다. 반면 가느다란 물건이나 화면 가장자리의 물건은 놓치기 쉽고, 그러면 사진이 그대로 돌아옵니다. 화면 가장자리에 선 키 큰 랙은 표현을 바꾼 두 가지 설명 모두에서 남아 있었고, 마스크를 쓰자 한 번에 지워졌습니다. 설명으로 지워지지 않을 때나 비슷한 물건 두 개 중 하나만 지울 때는 mask_url을 보내십시오.
설명이 아무것에도 맞지 않으면 어떻게 되나요?
사진이 바뀌지 않은 채 돌아오고 요청은 완료로 처리됩니다. 실제로 찍혀 있는 대상을 지정하고, 같은 것이 여러 개라면 위치도 덧붙여 주십시오.
마스크는 어떻게 만들어야 하나요?
사진과 같은 크기로, 사라질 부분은 흰색, 나머지는 모두 검은색으로 만듭니다. 윤곽선과 그림자까지 지워지도록 물건 가장자리보다 조금 넓게 칠해 주십시오.
빈자리에 새 물건을 넣을 수 있나요?
아닙니다. 지우고 주변에 맞는 배경으로 채우기만 합니다.
Object Eraser API의 제한은 무엇인가요?
프롬프트 길이(글자): 1,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Object Eraser을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Object Eraser을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

