Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A imagem de partida. |
Preços
Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.
| Opção | Créditos por imagem | ≈ USD |
|---|---|---|
| Padrão | 7,5 | US$ 0,075 |
Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 8 créditos por imagem (US$ 0,08).
Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.
Início rápido da API
Chame a API do Celebrity Look-Alike em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
- Envie a requisição. Faça POST /jobs/createTask com model popnow/look-alike-v1/edit e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 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/look-alike-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'
# 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"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Celebrity Look-Alike
Quanto custa a API do Celebrity Look-Alike?
O Celebrity Look-Alike custa 8 créditos (US$ 0,08) por imagem. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.
Qual é o nome de modelo do Celebrity Look-Alike na API?
Coloque popnow/look-alike-v1/edit para Troca de rosto no campo model de POST /jobs/createTask.
O que exatamente volta?
Uma imagem gerada. O endpoint não devolve nome de celebridade, lista de candidatos nem porcentagem de semelhança, então tudo o que o seu produto exibir precisa ser construído em torno da própria imagem.
Funciona com fotos de grupo?
Não. Envie um rosto por requisição. Com vários rostos no enquadramento não há como dizer a qual pessoa você se referia, e o resultado passa a ser arbitrário.
Dá para ajustar o resultado?
Não. Não há prompt, seed, tamanho nem controle de formato. A foto que você envia é a única entrada que muda o resultado.
Isso é reconhecimento facial?
Trate como se fosse na hora de decidir se você pode usar. A entrada é o rosto de uma pessoa real, o que coloca o recurso sob regras de dados biométricos e de imagem em várias jurisdições, independentemente de como ele é apresentado no seu produto. Use apenas com o consentimento da pessoa retratada e leia a seção Limits antes de publicar.
Posso usar em fotos de celebridades ou figuras públicas?
Não use. Enviar a foto de uma figura pública, ou apresentar a saída como uma afirmação sobre uma pessoa real, é exatamente onde direitos de imagem e de personalidade são violados. A entrada prevista é o retrato do próprio usuário, com consentimento.
Dá para testar o Celebrity Look-Alike sem escrever código?
Dá. O Playground roda o Celebrity Look-Alike com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.

