API de face swap em vídeo para fluxos de produção
Adicione a substituição de rostos mediante autorização aos seus pipelines de vídeo pela API da GoEnhance. Envie um vídeo de destino, uma imagem do rosto de origem, as configurações de saída e um trecho com tempo definido; depois guarde o ID da tarefa retornado e busque o resultado assíncrono.
Obter acesso à API
Um contrato enxuto de API de face swap em vídeo
Prepare a requisição de vídeo com intervalo
Envie reference_video como o clipe de destino e reference_img como a imagem do rosto. A referência atual documenta tamanhos máximos de 200 MB e 5 MB, além dos campos obrigatórios start_time, end_time e upscaler.
Obtenha a conclusão de forma assíncrona
Um envio bem-sucedido retorna data.img_uuid. Faça polling em GET /api/v1/jobs/detail ou informe um callback HTTPS público, trate os estados pending, processing, success e failed e verifique as entradas de resultado tipadas antes de guardar o vídeo final.
Construa sua integração em torno do contrato documentado de requisição, tarefa e resultado.
Recursos que fazem diferença em produção
Requisições autenticadas com Bearer
Mantenha a chave da API da GoEnhance no seu servidor e envie-a no cabeçalho Authorization. Nunca exponha credenciais de produção em código que roda no navegador.
Papéis explícitos para cada arquivo
Use <code>reference_video</code> para o clipe de destino e <code>reference_img</code> para o rosto a ser transferido, evitando o erro comum de inverter as entradas.
Arquivos de origem com limites definidos
Verifique se os arquivos estão acessíveis antes do envio. A referência atual do endpoint documenta o máximo de 200 MB para o vídeo e de 5 MB para a imagem.
Trechos de conversão por tempo
Informe <code>start_time</code> e <code>end_time</code> entre 0 e 120 segundos e valide se o intervalo escolhido faz sentido para o clipe de origem.
Controles de saída e de aprimoramento
Escolha <code>upscaler</code> 1 para 720p ou 2 para 1080p, exclusivo para VIP, e ative <code>enhance_face</code> apenas quando o fluxo realmente exigir.
Resultados assíncronos tipados
Guarde o <code>img_uuid</code>, trate todos os estados finais, verifique as entradas de resultado por <code>type</code> e copie a saída bem-sucedida antes que os links temporários expirem.
Use a página de faturamento em tempo real e o saldo da conta como fonte da verdade.
Preços da API de face swap em vídeo sem achismo
Consulte o preço atual da API de face swap em vídeo
A referência do endpoint documenta multiplicadores de custo, mas não uma tarifa base fixa. Confirme a cobrança base atual na página de faturamento da GoEnhance antes de projetar gastos.
Considere os multiplicadores opcionais
A referência atual marca a saída em 1080p e o aprimoramento de rosto como opções com preço 1.5x. Ela não explica como opções combinadas são calculadas, então confira a cobrança real em vez de supor.
Monitore créditos e orçamento
Use <code>GET /api/v1/user/tokens</code> para ler <code>data.count</code> e acrescente limites por cliente, registros de tarefas e alertas em torno dos preços atuais da API da GoEnhance.
Integre a API da GoEnhance em três passos
1
1. Valide a autorização e os arquivos
Confirme o consentimento e os direitos de uso, verifique se as duas URLs estão acessíveis, aplique os limites documentados de tamanho e de tempo e recuse entradas não suportadas ou ambíguas antes do envio.
2
2. Crie e guarde a tarefa
Faça POST dos arquivos obrigatórios, do intervalo de tempo e da configuração de saída para
/api/v1/videofaceswap/generate; verifique o sucesso no nível do HTTP e da resposta e então guarde o data.img_uuid. 3
3. Acompanhe, revise e armazene o resultado
Faça polling com backoff ou verifique a entrega dos callbacks, trate cada status final e tipo de resultado, revise a troca de rosto quanto à identidade e à consistência entre os quadros e mova o material aprovado para um armazenamento durável.
Trate consentimento, transparência e controle de acesso como requisitos de produto, não como um texto opcional.
Casos de uso úteis e baseados em autorização
Variações de campanha com consentimento
Crie variações de vídeo aprovadas para talentos, embaixadores ou clientes que autorizaram expressamente o uso da própria imagem.
Pré-visualização audiovisual
Faça protótipos de elenco ou de continuidade de cena antes da produção final, mantendo a revisão humana e a liberação de direitos no fluxo.
Produção criativa localizada
Adapte material aprovado para campanhas regionais mantendo permissões de origem rastreáveis, avisos de transparência e registros de revisão.
Ferramentas de entretenimento com opt-in
Sustente experiências em que a pessoa usuária fornece conscientemente o clipe de destino e o retrato de origem e entende que o resultado é sintético.
Protótipos internos controlados
Avalie enquadramento e direção conceitual sem apresentar o material gerado como um acontecimento autêntico ou um endosso real.
Aplicações de mídia com moderação
Combine a troca de rostos com controles de acesso, denúncia de abusos, limites de retenção, registros de procedência e etapas de aprovação.
Respostas práticas sobre integração, preços, tratamento de tarefas e uso responsável.