Celebrity Look-Alike API

popnow/look-alike-v1/editA partir de 8 créditos por imagem

O Celebrity Look-Alike recebe um único retrato e devolve uma imagem gerada da celebridade mais parecida. Um campo de imagem, sem prompt e sem parâmetros: é um recurso de uma chamada só, feito para entretenimento e mecânicas sociais, não uma ferramenta de identificação.

Chame com o nome de modelo popnow/look-alike-v1/edit em POST /jobs/createTask, a partir de 8 créditos por imagem (US$ 0,08). Contas novas ganham 30 créditos grátis para você testar primeiro no Playground.

  • Troca de rosto

Por enquanto este guia está só em inglês. →

Parâmetros da requisição

ParâmetroObrigatórioDescrição
image_urlSimA 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çãoCréditos por imagem≈ USD
Padrão7,5US$ 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

  1. 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.
  2. 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.
  3. 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.

Mais sobre o Celebrity Look-Alike