API de intercambio de rostros en imágenes para flujos de trabajo de producción
Añada el reemplazo de rostros basado en el consentimiento a los canales de procesamiento de imágenes a través de la API de GoEnhance. Envíe una imagen de destino y un rostro de origen, guarde el ID de tarea devuelto y luego realice sondeos o reciba devoluciones de llamada hasta que el resultado alcance un estado terminal.
Obtener acceso a la API
Un contrato de API de intercambio de rostros en imágenes enfocado
Envíe las dos imágenes requeridas
Envíe reference_img como la imagen de destino y source_img como la imagen del rostro. Ambas son URLs de imagen HTTPS obligatorias, y la referencia actual de la API documenta un máximo de 5 MB para cada entrada.
Seguimiento de la finalización sin bloqueo
Un envío exitoso devuelve un img_uuid. Consulte GET /api/v1/jobs/detail o proporcione una URL de devolución de llamada HTTPS pública y maneje explícitamente los resultados pendientes, en procesamiento, exitosos y fallidos.
Construya alrededor del contrato documentado de solicitud, tarea y resultado.
Capacidades que importan en la producción
Solicitudes autenticadas con Bearer
Mantenga la clave de API de GoEnhance en su servidor y envíela en el encabezado de autorización. Nunca exponga las credenciales de producción en el código del navegador.
Roles explícitos de destino y origen
Utilice <code>reference_img</code> para la composición de destino y <code>source_img</code> para el rostro a transferir, evitando errores comunes de orden de entrada.
Validación de activos HTTPS
Valide que ambas URLs de imagen sean accesibles por la API y permanezcan dentro del límite documentado de 5 MB antes de crear una tarea.
IDs de tareas asíncronas
Persista el <code>img_uuid</code> devuelto para que los trabajadores, reintentos, devoluciones de llamada y comprobaciones de estado orientadas al cliente se refieran al mismo trabajo.
Sondeo o devoluciones de llamada
Realice sondeos al endpoint de detalles del trabajo con retroceso, o acepte devoluciones de llamada de cambio de estado en un endpoint HTTPS públicamente accesible.
Manejo de resultados tipados
Inspeccione cada entrada de resultado por <code>type</code> en lugar de asumir que el primer elemento es siempre una URL de imagen, y copie las salidas que caducan en su propio almacenamiento aprobado.
Utilice los precios actuales de la cuenta y los datos de saldo como fuente de información veraz.
Precios de la API de intercambio de rostros en imágenes sin conjeturas
Compruebe los precios en vivo de la API de intercambio de rostros en imágenes
La referencia actual del endpoint público no publica una tasa fija de tokens por imagen. Confirme el cargo en vivo en la página de facturación de GoEnhance antes de pronosticar el gasto en lugar de confiar en un número inventado o desactualizado.
Monitorear el saldo de tokens
Utilice <code>GET /api/v1/user/tokens</code> para leer el saldo disponible desde <code>data.count</code> y activar alertas internas antes de enviar los trabajos.
Establezca presupuestos a nivel de aplicación
Registre la creación de tareas y los resultados finales, limite el uso por inquilino y concilie la actividad facturada con los precios de su cuenta de GoEnhance.
Integre la API de GoEnhance en tres pasos
1
1. Validar el consentimiento y las entradas
Confirme que tiene permiso para usar ambos rostros, verifique el acceso HTTPS, aplique el límite de tamaño de archivo documentado y rechace los activos no compatibles o ambiguos antes del envío.
2
2. Crear y persistir la tarea
Envíe mediante POST las dos URL de imagen a
/api/v1/imagefaceswap/generate, verifique tanto el éxito HTTP como el de nivel de respuesta, y almacene el img_uuid devuelto. 3
3. Resolver y almacenar el resultado
Realice sondeos con retroceso exponencial o verifique las entregas de devolución de llamada (callback), bifurque según el estado final y el tipo de resultado, luego mueva la salida exitosa al almacenamiento duradero antes de que expiren los enlaces temporales.
Trate el consentimiento, la divulgación y el control de acceso como requisitos del producto, no como texto opcional.
Casos de uso útiles basados en permisos
Personalización de campañas con consentimiento
Genere variaciones creativas aprobadas para talentos, embajadores o clientes que hayan autorizado explícitamente el uso de su imagen.
Cine y previsualización
Cree marcos conceptuales internos o vistas previas de casting mientras mantiene la revisión final y la autorización de derechos en el proceso de producción.
Flujos de trabajo creativos localizados
Adapte los activos visuales aprobados para campañas regionales mientras conserva los permisos de origen rastreables y la revisión humana.
Experiencias de avatar y perfil
Potencie experimentos de avatar con consentimiento donde los usuarios proporcionen conscientemente tanto la imagen de destino como el rostro de origen.
Prototipado creativo
Pruebe diseños y direcciones visuales antes de encargar la fotografía final, sin presentar la salida sintética como un evento auténtico.
Herramientas de medios moderados
Añada el intercambio de rostros a aplicaciones controladas con verificaciones de consentimiento, informes de abuso, reglas de retención y puertas de revisión durante la generación.
Respuestas prácticas para la integración, precios, gestión de tareas y uso responsable.