PopNowDocs da API
Conteúdo principal

Referência da API do Object Eraser

Apague qualquer coisa pelo nome ou pincel, com preenchimento natural

Com uma única chave de API da PopNow você chama o Object Eraser direto do seu código. Aqui estão os IDs de modelo a enviar, cada campo de entrada aceito, quantos créditos custa cada requisição e um exemplo que você cola no terminal e roda.

As descrições dos parâmetros vêm do schema de entrada do modelo e estão disponíveis só em inglês.

Resumo

Desenvolvedor
PopNow
Resultado
Imagem
A partir de
4.5 créditos por imagem ($0.045)
Tempo médio
cerca de 36 s

1 crédito = US$ 0,01. Ao ser aceita, a tarefa reserva o valor máximo possível e, no fim, cobra o uso real, arredondado para cima em créditos inteiros; o restante é liberado. Tarefas que falham não são cobradas. Para saber o valor exato antes de rodar, chame POST /api/v1/jobs/quote.

Apagar objeto

popnow/object-eraser-v1/edit

Preço

OpçãoCréditos (por imagem)Dólares
Padrão4.5$0.045

Parâmetros

CampoTipoPadrãoValores aceitosPara que serve
image_urlObrigatóriostring——Photo to clean up. The selected objects are removed and the space is filled to match the scene.
promptOpcionalstring—até 1.000 caracteresWhat 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_urlOpcionalstring——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_formatOpcionalstringpngpng, jpeg, webpFile format of the returned image.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em POPNOW_API_KEY.

O exemplo usa arquivos de amostra da PopNow em image_url. Troque pelos seus próprios links HTTPS públicos, uploads ou assets salvos.

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/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"
  }
}'

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

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"

Próximos passos

Nesta página