Introdução
Recebe um único retrato e devolve uma imagem gerada da celebridade mais parecida. Não há prompt nem parâmetros: a foto é a entrada inteira.
A requisição é uma URL de imagem, cobrada por requisição. É uma função de uma só chamada pensada para produtos de entretenimento e redes sociais, não uma ferramenta de identificação.
Recursos e destaques
Uma foto entra, uma imagem sai — não há mais nada para enviar
A requisição inteira é uma única URL de imagem. Não há prompt, seed, tamanho nem intensidade, então a foto enviada é a única coisa que move o resultado. Envie e consulte a tarefa para pegar a imagem, do mesmo jeito que em qualquer outra chamada de mídia deste catálogo; o preço por requisição é o mesmo, seja quem for que apareça na imagem.
Uma imagem gerada, não um nome nem uma nota
A resposta traz uma imagem e nada mais: nem o nome da celebridade, nem uma lista de candidatos, nem um percentual de semelhança. O que ficar ao lado da imagem é texto seu, não uma afirmação do modelo, e assim é mais seguro. Monte a experiência em torno da própria imagem: mostre, deixe compartilhar e evite colocar um número ao lado.
Para decidir se você pode usar, trate como reconhecimento facial
A entrada é sempre o rosto de uma pessoa real, o que coloca este endpoint sob regras de imagem pessoal e dados biométricos que nada mais neste catálogo toca. Dados biométricos têm regulação específica na União Europeia e em partes dos Estados Unidos, e ali a exigência de consentimento pode ser alta. Envie só fotos em que a pessoa retratada concordou conscientemente — nunca de uma figura pública, nunca imagens tiradas de outro lugar — e nunca use para identificar, verificar, vigiar ou montar uma base de rostos. Nada do que volta é uma afirmação factual sobre uma pessoa real; imagens de origem enviadas são apagadas depois de um dia, e resultados gerados, depois de 14.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | Um retrato nítido e mais ou menos frontal, com um único rosto visível. pelo menos 1 caracteres |
Preços
$0.05 / requisição
Um resultado que você não teria escolhido ainda é uma requisição concluída e é cobrado.
Casos de uso
Um envio, uma imagem para compartilhar
Use este endpoint quando a experiência do produto for enviar uma única foto e receber uma imagem gerada para compartilhar. Envie o retrato como image_url, consulte a tarefa e mostre a imagem que voltar; não há nome nem nota para exibir ao lado.
Recursos de entretenimento e redes sociais
A interação “com qual celebridade você se parece?” como uma única chamada de API por trás de um envio de foto. É um momento compartilhável dentro de um app para o consumidor, não uma ferramenta de produção.
Mecânicas de campanha
Uma etapa interativa leve dentro de um fluxo de marketing: envie uma selfie, receba uma imagem para compartilhar. Uma chamada por participante mantém o custo previsível.
Apps de foto e beleza
Um recurso divertido ao lado das ferramentas de retrato que já existem. Não exige engenharia de prompt nem parâmetros, então entra num app com um único campo de formulário.
Guia de prompt e dicas práticas
Espere uma imagem, não um veredito
O endpoint devolve uma imagem gerada, não um nome, um ranking ou uma nota de semelhança. Se o seu produto precisa de um rótulo, é a própria imagem que você tem de apresentar — a API não dá mais nada para mostrar.
Envie um retrato nítido e de frente
Um único rosto bem iluminado, mais ou menos voltado para a câmera, ocupando uma parte razoável do quadro. Fotos de grupo, perfis muito marcados, óculos de sol, borrão de movimento e rostos muito pequenos são os casos em que a semelhança piora ou a chamada falha de vez.
Confira o resultado antes de iterar
Um rosto por imagem, mais ou menos de frente e bem iluminado. Perfis, obstruções (óculos de sol, mãos, cabelo no rosto), borrão de movimento e rostos muito pequenos pioram a semelhança ou fazem a chamada falhar. Não há prompt, máscara, intensidade nem seed: se o resultado estiver errado, a única saída é outra foto. A resposta é uma imagem e nada mais — sem nome, sem ranking, sem valor de confiança.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/look-alike-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.

