Video Face Swap API

O Video Face Swap leva os traços faciais de uma única imagem de referência para a pessoa que aparece em um vídeo, em todos os quadros do clipe. Só os traços mudam de lugar: o penteado, o contorno da cabeça, os movimentos, o figurino, a iluminação, o movimento de câmera e o fundo ficam exatamente como foram gravados, e é por isso que o resultado parece a gravação original, e não uma camada colada por cima.

O Video Face Swap recebe um clipe de vídeo e uma imagem de rosto de referência e leva apenas os traços faciais para a pessoa na gravação, mantendo cabelo, movimentos, enquadramento e fundo. São duas URLs e um acabamento opcional: não existe campo de prompt para escrever.

Preserve a atuação, troque a identidade facial

Face Swap aplica a identidade da referência aprovada à pessoa do vídeo fornecido e preserva a atuação gravada. Escolha um clipe cujo sujeito, enquadramento e luz já funcionem: este fluxo troca a identidade, não reconstrói uma cena.

Revise a continuidade, não uma cena sintética

Avalie o resultado em velocidade normal nas viradas, nos cortes e nos movimentos rápidos. Confira se a troca de identidade continua coerente enquanto cabelo, movimento, figurino e fundo ainda parecem o vídeo original.

Altere um clipe fornecido

O Video Face Swap leva os traços faciais de uma única imagem de referência para a pessoa que aparece em um vídeo, em todos os quadros do clipe. Só os traços mudam de lugar: o penteado, o contorno da cabeça, os movimentos, o figurino, a iluminação, o movimento de câmera e o fundo ficam exatamente como foram gravados, e é por isso que o resultado parece a gravação original, e não uma camada colada por cima. Use este modo quando o vídeo de origem deve ser o ponto de partida de uma edição. Descreva a alteração com precisão e revise continuidade, ritmo e os detalhes que devem ser preservados.

Um mesmo rosto em toda uma série gerada

Gere uma série de clipes com qualquer modelo de vídeo e leve para todos um mesmo rosto autorizado, para que a série mostre a mesma pessoa. Movimentos, figurino e cenário continuam sendo os de cada clipe, então a variedade que você gerou sobrevive à troca.

Conteúdo sem censura com a imagem de um intérprete que consentiu

Leve um rosto que você tem autorização para usar a um material que você mesmo produziu. Nada muda na requisição por se tratar de conteúdo sem censura, mas a exigência de autorização descrita nos limites abaixo é uma condição firme, não uma formalidade.

Trocar o intérprete de uma tomada que já funciona

Mantenha uma tomada cuja iluminação, marcação e movimento de câmera já foram aprovados e coloque outro rosto nela, em vez de gerar o plano inteiro de novo e perder a atuação que você já tinha.

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

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