Referência da API do Video Face Swap

Com uma única chave de API da PopNow você chama o Video Face Swap direto do seu código. Aqui estão os IDs de modelo a enviar, cada campo de entrada aceito, quantos créditos custa cada requisição e um exemplo que você cola no terminal e roda.

As descrições dos parâmetros vêm do schema de entrada do modelo e estão disponíveis só em inglês.

Resumo

Desenvolvedor: PopNow
Resultado: Vídeo
A partir de: 3.9 créditos por segundo gerado ($0.039)
Tempo médio: cerca de 37 s
IDs de modelo: popnow/face-swap-video-v1/video-edit

1 crédito = US$ 0,01. Ao ser aceita, a tarefa reserva o valor máximo possível e, no fim, cobra o uso real, arredondado para cima em créditos inteiros; o restante é liberado. Tarefas que falham não são cobradas. Para saber o valor exato antes de rodar, chame POST /api/v1/jobs/quote.

Troca de personagem

popnow/face-swap-video-v1/video-edit

Preço

Opção	Créditos (por segundo gerado)	Dólares
`Padrão`	3.9	$0.039

Parâmetros

Campo	Tipo	Padrão	Valores aceitos	Para que serve
`video_url`Obrigatório	`string`	—	—	Target video. The face of the person in this clip is the one that gets replaced.
`reference_image_url`Obrigatório	`string`	—	—	Reference face image. The facial features from this image are carried onto the person in the video.
`face_mapping`Opcional	`array<object>`	—	até 10 itens	Multi-person swap: which face in the reference image goes onto which face in the target, one entry per face. Faces are numbered from 0 in detection order. Leave it out to swap a single face.
`face_enhance`Opcional	`boolean`	`false`	—	Run a face-enhancement pass on the swapped face for a sharper, more detailed result.
`style`Opcional	`string`	`realistic`	realistic, beautify, lossless	Finish applied to the swapped face: realistic keeps natural skin tone and texture, beautify smooths and brightens the skin, lossless holds on to the most facial detail.

Exemplo de requisição

Esta requisição roda do jeito que está; os campos que você omitir usam o valor padrão. Antes, coloque sua chave em POPNOW_API_KEY.

O exemplo usa arquivos de amostra da PopNow em reference_image_url, video_url. Troque pelos seus próprios links HTTPS públicos, uploads ou assets salvos.

POST /api/v1/jobs/createTask?wait=60

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "popnow/face-swap-video-v1/video-edit",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp"
  }
}'

A resposta já traz um taskId. Busque o resultado com GET /api/v1/jobs/recordInfo ou inclua callBackUrl para ser avisado.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"