API de face swap en vídeo para flujos de producción
Añade sustitución facial con permiso a tus pipelines de vídeo mediante la API de GoEnhance. Envía un vídeo de destino, una imagen del rostro de origen, los ajustes de salida y un segmento temporizado; después guarda el ID de tarea devuelto y recupera el resultado asíncrono.
Obtener acceso a la API
Un contrato de API de face swap en vídeo bien delimitado
Prepara la petición de vídeo con intervalo
Envía reference_video como clip de destino y reference_img como imagen del rostro. La referencia actual documenta tamaños máximos de 200 MB y 5 MB, además de los campos obligatorios start_time, end_time y upscaler.
Resuelve la finalización de forma asíncrona
Un envío correcto devuelve data.img_uuid. Consulta GET /api/v1/jobs/detail mediante polling o indica un callback HTTPS público, gestiona los estados pending, processing, success y failed, y revisa las entradas de resultado tipadas antes de guardar el vídeo final.
Diseña tu integración en torno al contrato documentado de petición, tarea y resultado.
Capacidades que importan en producción
Peticiones autenticadas con Bearer
Guarda la clave de la API de GoEnhance en tu servidor y envíala en la cabecera Authorization. Nunca expongas credenciales de producción en el código del navegador.
Roles explícitos para cada archivo
Usa <code>reference_video</code> para el clip de destino y <code>reference_img</code> para el rostro que quieres transferir; así evitas el error habitual de invertir las entradas.
Archivos de origen acotados
Comprueba que los archivos son accesibles antes de enviarlos. La referencia actual del endpoint documenta un máximo de 200 MB para el vídeo y de 5 MB para la imagen.
Segmentos de conversión temporizados
Indica <code>start_time</code> y <code>end_time</code> entre 0 y 120 segundos, y valida que el intervalo elegido tenga sentido para el clip de origen.
Controles de salida y de mejora
Elige <code>upscaler</code> 1 para 720p o 2 para 1080p, exclusivo de VIP, y activa <code>enhance_face</code> solo cuando el flujo lo requiera.
Resultados asíncronos tipados
Guarda <code>img_uuid</code>, gestiona todos los estados finales, revisa las entradas de resultado por <code>type</code> y copia la salida correcta antes de que caduquen los enlaces temporales.
Toma como fuente fiable la página de facturación en vivo y el saldo de tu cuenta.
Precios de la API de face swap en vídeo sin conjeturas
Consulta el precio actual de la API de face swap en vídeo
La referencia del endpoint documenta multiplicadores de coste, pero no una tarifa base fija. Confirma el cargo base actual en la página de facturación de GoEnhance antes de estimar el gasto.
Ten en cuenta los multiplicadores opcionales
La referencia actual marca la salida en 1080p y la mejora facial como opciones con precio 1.5x. No explica cómo se calculan las opciones combinadas, así que verifica el cargo real en lugar de darlo por supuesto.
Vigila los créditos y el presupuesto
Usa <code>GET /api/v1/user/tokens</code> para leer <code>data.count</code> y añade límites por inquilino, registros de tareas y alertas en torno a los precios actuales de la API de GoEnhance.
Integra la API de GoEnhance en tres pasos
1
1. Valida el permiso y los archivos
Confirma el consentimiento y los derechos de uso, comprueba que ambas URL son accesibles, aplica los límites documentados de tamaño y tiempo, y rechaza las entradas no admitidas o ambiguas antes de enviarlas.
2
2. Crea y guarda la tarea
Envía por POST los archivos obligatorios, el intervalo de tiempo y el ajuste de salida a
/api/v1/videofaceswap/generate; comprueba el éxito a nivel de HTTP y de respuesta, y guarda después data.img_uuid. 3
3. Sigue, revisa y guarda el resultado
Haz polling con backoff o verifica la entrega de los callbacks, ramifica según el estado final y el tipo de resultado, revisa el face swap en cuanto a identidad y coherencia entre fotogramas, y mueve el material aprobado a un almacenamiento duradero.
Trata el consentimiento, la divulgación y el control de acceso como requisitos de producto, no como un texto opcional.
Casos de uso útiles y basados en permiso
Variantes de campaña con consentimiento
Crea variantes de vídeo aprobadas para artistas, embajadores o clientes que hayan autorizado expresamente el uso de su imagen.
Previsualización cinematográfica
Prototipa el reparto o la continuidad de las escenas antes de la producción final, manteniendo en el flujo la revisión humana y la gestión de derechos.
Producción creativa localizada
Adapta material aprobado a campañas regionales conservando permisos de origen trazables, avisos de divulgación y registros de revisión.
Herramientas de entretenimiento con opt-in
Impulsa experiencias en las que las personas usuarias aportan conscientemente el clip de destino y el retrato de origen, y entienden que el resultado es sintético.
Prototipos internos controlados
Evalúa el encuadre y la dirección conceptual sin presentar el material generado como un hecho auténtico ni como un respaldo real.
Aplicaciones de medios con moderación
Combina el face swap con controles de acceso, denuncia de abusos, límites de retención, registros de procedencia y aprobaciones previas.
Respuestas prácticas sobre integración, precios, gestión de tareas y uso responsable.