Crie um recurso de sósia de celebridade a partir de um retrato sem inventar uma pontuação de semelhança

O Celebrity Look-Alike (look-alike-v1) transforma um retrato em uma imagem gerada de sósia de celebridade, por US$ 0,05 por solicitação. A resposta é apenas uma imagem: sem campo de ID de celebridade, sem ranking, sem pontuação de similaridade. A imagem pode ser um layout de dois painéis com manchete impressa, o nome de uma celebridade e uma assinatura em estilo manuscrito, e as letras podem sair distorcidas. Planeje o cartão de compartilhamento com isso em mente e nunca apresente o nome como identificação verificada.

O Look-Alike combina com um recurso de entretenimento voluntário: o usuário envia uma selfie e recebe uma imagem compartilhável. Ele não tem prompt, seletor de pessoa-alvo nem controle de intensidade; para uma troca de roupa dirigida ou um personagem fictício recorrente, use um editor de imagens.

Escolha o tipo certo de API de «sósia»

A maioria das ferramentas de sósia é, na verdade, uma de duas outras coisas. Serviços de reconhecimento facial e projetos de código aberto convertem um rosto em um vetor, pesquisam um banco de dados de celebridades e devolvem nomes com pontuações. Buscadores para o consumidor mostram porcentagens como «92% de correspondência» sem nenhum método por trás. O Look-Alike não faz nenhuma das duas coisas.

O que o endpoint aceita

Um resultado de exemplo do Look-Alike, da página do modelo: a imagem devolvida é uma colagem de dois painéis com manchete e com o nome de uma pessoa real impresso, então um layout que presuma um retrato único e limpo vai quebrar.

O exemplo da página do modelo é uma colagem de dois painéis com nome impresso e assinatura, então espere letras na imagem e planeje para isso. Visualize a exportação real no tamanho do seu cartão, mantenha as proporções (esticá-la para um quadrado distorce os rostos) e, se você cortar as letras, o rosto restante continua não sendo uma correspondência verificada.

Prepare a foto de origem

A página do modelo lista os casos de falha: fotos em grupo, perfis, óculos escuros, mãos ou cabelo sobre o rosto, desfoque de movimento e rostos muito pequenos pioram a correspondência ou fazem a chamada falhar. Use um único rosto, bem iluminado e mais ou menos de frente, que ocupe uma parte razoável do quadro, com os dois olhos e a linha do cabelo visíveis. Aplique orientação e corte antes do envio, porque a miniatura de uma galeria pode ignorar metadados de rotação que os bytes enviados ainda carregam. Ampliar um rosto minúsculo de uma foto em grupo não acrescenta detalhe; peça uma foto nova.

Ilustração, não um resultado do Look-Alike: um retrato adulto mais ou menos frontal mostra um enquadramento de entrada legível.

Experimente primeiro no Playground

1. Abra a página do Look-Alike e fique na aba Playground, na visualização Form. Entre com uma conta com saldo para executar.
2. Solte o retrato de um adulto que tenha dado consentimento em Input image (JPG, PNG, WEBP ou GIF, até 10 MB) ou cole um link direto em Asset URL. Não há mais nada para configurar.
3. Execute, depois abra a imagem inteira devolvida e revise-a como descrito abaixo.

Teste aqui a sua foto de origem mais difícil antes de escrever código: se a correspondência estiver errada no Playground, estará errada pela API também, e a solução é uma foto melhor.

Depois, chame pelo código

Instale o SDK Python (pip install spicyapi), defina SPICY_API_KEY no ambiente do seu servidor e execute:

import urllib.request
import uuid

from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

photo = client.upload_file("./authorized-adult-portrait.jpg")  # becomes a spicy:// URI

task = client.create_task(
    model="spicyapi/look-alike-v1/edit",
    input_data={"image_url": photo["uri"]},
    idempotency_key=str(uuid.uuid4()),  # new key per new request; reuse only to retry the same one
)

final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")

url = output_assets(final)[0]["url"]
# some script clients get 403 without a User-Agent
request = urllib.request.Request(url, headers={"User-Agent": "look-alike-example/1.0"})
with urllib.request.urlopen(request) as response, open("look-alike.webp", "wb") as out:
    out.write(response.read())

Envie apenas image_url; propriedades adicionais, como o nome de uma celebridade, são rejeitadas. Uploads, espera e novas tentativas são explicados no guia de tarefas e na referência do SDK Python. Para webhooks, consulte o guia de polling versus webhooks. Os resultados são excluídos após 14 dias; portanto, copie a imagem para seu próprio armazenamento se o usuário quiser guardá-la.

Ou deixe um Agent executar

Quando um assistente deve executar as solicitações, a CLI e o servidor MCP mostram o preço e pedem sua confirmação antes de uma chamada paga; o Skill só acrescenta instruções.

• CLI. O spicyapi executa uma tarefa a partir de um terminal (npx @spicyapi/cli funciona sem instalar). Coloque {"image_url": "spicy://..."} em input.json, usando o URI que o envio imprime:

``bash spicyapi files upload ./authorized-adult-portrait.jpg spicyapi tasks create --model spicyapi/look-alike-v1/edit --input-file input.json --wait ``

• Servidor MCP. Adicione o servidor MCP ao seu assistente e peça: «Run Look-Alike on ./authorized-adult-portrait.jpg.» Ele chama spicyapi_upload_file, depois spicyapi_task_create, que para para você confirmar o preço, e então spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill instala o Agent Skill, que faz um assistente de programação ler o esquema atual do modelo em vez de adivinhar campos. Ele não consegue executar tarefas sozinho, então use-o junto com a CLI ou o MCP.

Revise o resultado antes do cartão de compartilhamento

Abra a imagem inteira devolvida, não um recorte do rosto. Procure painéis extras, manchetes, nomes reais, assinaturas, rostos adicionais e uma idade aparente alterada. Rotule o resultado como Generated look-alike portrait (retrato de sósia gerado). Se não quiser mostrar o nome, corte ou cubra as letras; o rosto restante continua não sendo uma correspondência verificada. Não coloque «93% de correspondência» nem «identidade de celebridade verificada» ao lado, e não mostre um nome extraído da imagem por outro modelo como se o Look-Alike o tivesse avaliado. As letras incorporadas são conteúdo gerado e podem estar erradas.

Ilustração, não um resultado do Look-Alike: revise a imagem inteira e tudo ao redor do rosto antes de escolher uma exportação.

Se o participante não gostar da imagem, ofereça descartá-la ou tentar outra foto. Nada direciona o resultado para uma celebridade escolhida, então repetir é um novo candidato de US$ 0,05, não um refinamento.

Consentimento e compartilhamento

A entrada é sempre o rosto de uma pessoa real, então trate o recurso como reconhecimento facial ao avaliar obrigações legais. Dados biométricos são regulados separadamente na UE e em partes dos Estados Unidos; a BIPA de Illinois, por exemplo, exige aviso por escrito e consentimento informado antes da coleta de identificadores biométricos. Use fotos de adultos que concordaram conscientemente com esta finalidade, nunca fotos de figuras públicas nem imagens tiradas de outros lugares, e não use o Look-Alike para identificação, verificação, vigilância ou para montar um banco de dados de rostos. Trate a permissão para gerar como separada da permissão para publicar a origem ou o resultado.

O Look-Alike funciona sem verificador de segurança, então o seu produto precisa aplicar suas próprias regras de idade e conteúdo. Não use retratos de pessoas reais para criar material sexual, íntimo ou difamatório e não apresente o resultado como uma afirmação sobre uma pessoa real. Um retrato de busto de um adulto totalmente vestido é a entrada padrão mais segura para um recurso público de entretenimento.

Monte um fluxo enxuto: uma pré-visualização privada da origem, um estado de processamento, o resultado completo e uma ação explícita de salvar ou compartilhar. Não publique automaticamente quando a geração terminar.