Head Swap API

Head Swap substitui a cabeça inteira da pessoa na imagem de destino pela cabeça de uma foto de referência. Rosto, penteado, cor do cabelo e silhueta do crânio são levados; corpo, roupa, pose, luz e fundo do destino continuam como estavam.

A requisição são duas URLs de imagem e um seed opcional: image_url é o corpo que fica e reference_image_url fornece a cabeça. Não há prompt, máscara nem controle de intensidade, e cada requisição devolve uma imagem.

Levar a cabeça completa de um personagem para uma foto existente

O Head Swap muda mais que a identidade do rosto: é o alcance certo quando o cabelo, a cor e a silhueta da cabeça do novo personagem precisam vir junto. Isso o torna útil para troca de personagem, conceitos de figurino e continuidade em que o penteado do destino não deve permanecer.

A transição do pescoço é o teste de aprovação

Escolha material de origem com ângulo de câmera e direção de luz compatíveis e com o pescoço visível. Revise em tamanho real a linha do cabelo, as orelhas, o queixo, a emenda do pescoço e a continuidade das sombras antes de aceitar um resultado: são essas bordas que mostram se as duas imagens realmente combinam.

Comece com um par de imagens controlado

Comece com uma única pessoa nítida em cada imagem e evite desfoque forte, obstruções ou perfis extremos. Quando o cabelo e a silhueta do próprio destino são essenciais para a foto, escolha o Face Swap em vez de forçar uma troca de cabeça inteira.

Trocar a cabeça inteira, não só o rosto

Use este endpoint quando o penteado, a cor do cabelo e a silhueta da cabeça da nova pessoa precisam chegar junto com ela. Revise em tamanho real a linha do cabelo, as orelhas e a emenda do pescoço antes de aceitar o resultado; se o cabelo do destino faz parte da foto, o Face Swap é a ferramenta mais restrita.

Trocar a cabeça de uma foto de corpo de que você já gosta

Quando a roupa, a pose e a luz de uma imagem já funcionam, trocar a cabeça é mais barato e previsível do que gerar a imagem inteira de novo e torcer para a composição sobreviver.

Fotos de figurino e cosplay

Coloque a cabeça e o penteado de um personagem sobre um corpo usando o figurino que você gerou. O uniforme de empregada, a pose e o cenário do café ficam exatamente como estavam, então o trabalho no figurino sobrevive à passada.

Qualquer cena com um rosto que tem consentimento

Leve uma cabeça que você tem autorização para usar para imagens que você mesmo produziu, seja qual for o conteúdo. O endpoint não trata esse material de forma diferente — o que vale é a exigência de consentimento dos limites abaixo, e ela não é uma formalidade.

# 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/head-swap-v1/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "reference_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.