API de Troca de Rosto em Imagens para Fluxos de Trabalho de Produção
Adicione a substituição de rosto baseada em consentimento aos pipelines de imagem através da API da GoEnhance. Envie uma imagem de destino e um rosto de origem, armazene o ID da tarefa retornado e, em seguida, faça polling ou receba callbacks até que o resultado atinja um estado terminal.
Obter Acesso à API
Um contrato de API de troca de rosto em imagem focado
Envie as duas imagens necessárias
Envie reference_img como a imagem de destino e source_img como a imagem do rosto. Ambas são URLs de imagem HTTPS obrigatórias, e a referência atual da API documenta um máximo de 5 MB para cada entrada.
Acompanhe a conclusão sem bloqueios
Uma submissão bem-sucedida retorna um img_uuid. Consulte GET /api/v1/jobs/detail ou forneça uma URL de callback HTTPS pública e trate explicitamente os resultados pendentes, em processamento, bem-sucedidos e com falha.
Construa em torno do contrato documentado de requisição, tarefa e resultado.
Capacidades que importam na produção
Requisições autenticadas por Bearer
Mantenha a chave da API da GoEnhance no seu servidor e envie-a no cabeçalho Authorization. Nunca exponha credenciais de produção no código do navegador.
Funções explícitas de destino e origem
Use <code>reference_img</code> para a composição de destino e <code>source_img</code> para o rosto a ser transferido, evitando erros comuns de ordem de entrada.
Validação de ativos HTTPS
Valide se ambas as URLs de imagem são acessíveis pela API e permanecem dentro do limite documentado de 5 MB antes de criar uma tarefa.
IDs de tarefas assíncronas
Persista o <code>img_uuid</code> retornado para que workers, tentativas de reenvio, callbacks e verificações de status voltadas ao cliente refiram-se ao mesmo trabalho.
Polling ou callbacks
Faça polling no endpoint de detalhes do trabalho com backoff, ou aceite callbacks de mudança de status em um endpoint HTTPS publicamente acessível.
Tratamento de resultados tipados
Inspecione cada entrada de resultado pelo <code>type</code> em vez de assumir que o primeiro item é sempre uma URL de imagem, e copie as saídas que expiram para seu próprio armazenamento aprovado.
Use o preço da conta atual e os dados de saldo como fonte de verdade.
Preço da API de troca de rosto em imagens sem suposições
Verifique os preços da API de troca de rosto em imagem em tempo real
A referência atual do endpoint público não publica uma taxa fixa de tokens por imagem. Confirme a cobrança em tempo real na página de faturamento da GoEnhance antes de prever gastos, em vez de confiar em um número inventado ou desatualizado.
Monitore o saldo de tokens
Use <code>GET /api/v1/user/tokens</code> para ler o saldo disponível em <code>data.count</code> e acionar alertas internos antes que os trabalhos sejam enviados.
Defina orçamentos em nível de aplicação
Registre a criação de tarefas e resultados finais, limite o uso por locatário e reconcilie a atividade faturada com o preço da sua conta GoEnhance.
Integre a API GoEnhance em três etapas
1
1. Valide o consentimento e as entradas
Confirme se você tem permissão para usar ambos os rostos, verifique o acesso HTTPS, aplique o limite de tamanho de arquivo documentado e rejeite ativos não suportados ou ambíguos antes do envio.
2
2. Crie e persista a tarefa
Envie via POST as duas URLs de imagem para
/api/v1/imagefaceswap/generate, verifique o sucesso tanto do HTTP quanto da resposta e armazene o img_uuid retornado. 3
3. Resolva e armazene o resultado
Faça a sondagem com backoff ou verifique as entregas de callback, ramifique com base no status final e no tipo de resultado, e então mova a saída bem-sucedida para um armazenamento durável antes que os links temporários expirem.
Trate o consentimento, a divulgação e o controle de acesso como requisitos do produto — não como texto opcional.
Casos de uso úteis e baseados em permissão
Personalização de campanha com consentimento
Gere variações criativas aprovadas para talentos, embaixadores ou clientes que autorizaram explicitamente o uso da imagem.
Filme e pré-visualização
Crie quadros conceituais internos ou prévias de elenco enquanto mantém a revisão final e a liberação de direitos no processo de produção.
Fluxos de trabalho criativos localizados
Adapte ativos visuais aprovados para campanhas regionais, mantendo permissões de origem rastreáveis e revisão humana.
Experiências de avatar e perfil
Potencialize experimentos de avatar com opt-in, onde os usuários fornecem conscientemente tanto a imagem de destino quanto o rosto de origem.
Prototipagem criativa
Teste layouts e direções visuais antes de encomendar a fotografia final, sem apresentar a saída sintética como um evento autêntico.
Ferramentas de mídia moderadas
Adicione a troca de rosto a aplicações controladas com verificações de consentimento, denúncia de abuso, regras de retenção e portões de revisão em torno da geração.
Respostas práticas para integração, preços, processamento de tarefas e uso responsável.