Face Swap API

Face Swap leva os traços do rosto de uma imagem para a pessoa de outra. Só os traços viajam: penteado, linha do cabelo, silhueta da cabeça, pose, roupa, luz e fundo da imagem de destino continuam como estavam, e é isso que faz o resultado se encaixar dentro da foto original em vez de ficar colado por cima.

A requisição são duas URLs de imagem e um seed opcional: image_url é a foto que vai mudar e reference_image_url fornece o rosto. Não há campo de prompt para escrever, e cada requisição devolve uma imagem.

A foto fica, a identidade muda

É a escolha mais restrita quando a foto de destino já tem o cabelo, a pose, a roupa, o enquadramento e o ambiente certos. Ela leva a identidade do rosto e protege o resto da composição aprovada, então trocar a pessoa não vira uma geração completa da imagem.

Feito para pares de imagens repetíveis

O fluxo é simples de propósito: prepare um destino e uma referência com direitos resolvidos e com ângulo e luz compatíveis, depois revise a linha do queixo, os olhos e a transição da pele. Isso o torna útil para variações controladas de avatares, catálogos e campanhas em que a foto precisa continuar reconhecível.

Defina o alcance da troca antes de começar

Use Face Swap quando o penteado e a silhueta da cabeça do destino fazem parte da composição. Se a nova identidade precisa trazer o cabelo e todo o formato da cabeça, mande o trabalho para o Head Swap; escolher o alcance certo evita uma nova execução desnecessária.

Um rosto novo para um retrato cujo cabelo já funciona

Use este endpoint quando o penteado, a linha do cabelo e a silhueta da cabeça da foto de destino fazem parte da composição e só os traços devem mudar. Envie o destino como image_url e o rosto como reference_image_url, e compare olhos e linha do queixo com a origem em tamanho real antes de aceitar o resultado.

Trocar a pessoa de uma foto de banco ou gerada

Pegue uma foto cuja luz, pose e cenário já funcionam e coloque outro rosto nela, em vez de gerar a imagem inteira de novo e perder a composição que você já tinha aprovado.

Fluxos em massa de avatares e fotos de perfil

Sem prompt para escrever, uma lista de pares destino-referência pode passar pelo endpoint de forma programática. Fixe um seed por par quando uma nova tentativa precisar ser comparável à primeira.

Personagens consistentes em todo um ensaio

Gere uma série de cenas com qualquer modelo e depois leve um mesmo rosto para todas, para a série ser lida como a mesma pessoa. Como cabelo e roupa continuam os de cada imagem de destino, a variação que você gerou sobrevive à passada.

# 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/face-swap-v1/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "reference_image_url": "https://example.com/reference.png",
    "style": "realistic"
  }
}'

# 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.