Ir al contenido principal

Video Face Swap de SpicyAPI lleva los rasgos faciales de una foto de referencia a la persona de un clip de video en cada cuadro, conservando peinado, movimiento, encuadre y fondo. Envía una URL de video y una imagen de rostro; un estilo define el acabado.

Desde $0.026/s

Playground

Entrada

Edición de video
1/1

Suelta un video o elige un archivo · 1 archivo · Máx. 90 MB · MP4

  • 1
1 / 1 archivos
El clip que se modifica. El pelo, la forma de la cabeza, los movimientos, el vestuario y toda la escena de esta persona se conservan; solo se sustituyen sus rasgos faciales. Tiene que ser un enlace directo al archivo de video en sí: una página que reproduce el video solo nos entrega HTML, la comprobación previa no lee ninguna duración en ella y la llamada falla con el importe reembolsado. Subir el archivo es la vía más fiable. mínimo 1 caracteres
1/1

Arrastra archivos o enlaces multimedia, pega o selecciona · 1 archivo · Máx. 10 MB · JPG · PNG · WEBP

  • 1
1 / 1 archivos
Una imagen fija que aporta los rasgos faciales. Solo se toma la cara, no el pelo ni la forma de la cabeza. Elige una iluminada más o menos desde la misma dirección que el clip. mínimo 1 caracteres
Correspondencia de rostros0/10
Para clips con varias personas: indica qué rostro de la referencia va sobre qué rostro del video, un par por entrada, con los rostros numerados desde 0 en el orden de detección. Si lo omites, se intercambia un solo rostro. No cambia el costo. máximo 10 elementos
Mejorar el rostro
Aplica una pasada de mejora facial al rostro intercambiado para darle más resolución. Desactivado por defecto. No cambia el costo.
Estilo
RealisticBeautifyLossless
realistic (por defecto) mantiene un tono y una textura de piel naturales; beautify suaviza e ilumina la piel; lossless conserva el máximo detalle de la cara de referencia. Empieza por realistic.
Filtro de seguridadDesactivado

SpicyAPI no ejecuta ningún filtro de seguridad en este modelo. Tu prompt y tus medios llegan al modelo tal como los escribes, y el propio modelo decide el resultado.

Comprobando tu cuenta antes de habilitar el envío y el cálculo de precios.

Salida

Listo para una nueva ejecución
Resultado de ejemplo

Modelos relacionados y tareas siguientes

¿No está el modelo que buscas?

Dinos cuál añadir y para qué lo usarías. Las solicitudes llegan directamente al equipo que decide los próximos modelos.

Dos URL de archivo y un esquema cerrado, facturado una vez por llamada

La API de Video Face Swap toma un MP4 (video_url) y una foto de referencia (reference_image_url), y devuelve el mismo material con el rostro de la referencia aplicado en cada fotograma. Solo hay tres claves definidas, siendo style, opcional, la tercera, y el cuerpo de la solicitud rechaza cualquier otra cosa. No hay resolution ni aspect_ratio para elegir: el clip devuelto conserva el encuadre y la duración del archivo enviado, y cada llamada se factura como una solicitud.

Abrir el Playground
Dos URL de archivo y un esquema cerrado, facturado una vez por llamada
Campos obligatorios
video_url y reference_image_url, ambos cadenas URL
Campo opcional
style, por defecto realistic, además beautify o lossless
Formatos aceptados
MP4 para el clip, JPEG, PNG o WebP para la referencia
Forma de salida
Heredada del clip original; sin campo resolution ni aspect_ratio
Ventana de la tarea
1.800 segundos de procesamiento por tarea enviada
Facturación
Una solicitud por llamada, sin componente por segundo
Ventana de la tarea
El límite recae en el tiempo de procesamiento, no en la duración del clipNada en el esquema acota cuánto puede durar el material detrás de video_url, y no existe un campo de duración. Lo que limita un clip largo son los 1.800 segundos que tiene una tarea para alcanzar un estado final, junto con un tiempo de procesamiento que crece con la duración y el tamaño del material.
Economía
Un clip, un cargo, sea cual sea su duraciónLa facturación es por solicitud en un único nivel de precio, así que un recorte de prueba corto y una entrevista larga ocupan la misma línea en la factura. No hay ningún componente por segundo que calcular de antemano, y dimensionar un lote se reduce a contar cuántas solicitudes contiene.
Esquema
Dos campos de archivo y un acabado opcional, nada másEl contrato se limita a video_url, reference_image_url y style, sin campo prompt, sin mask y sin seed en ningún lugar del esquema. Un resultado fallido se diagnostica revisando los dos archivos enviados, nunca reformulando la solicitud.

En qué destaca la API de Video Face Swap

Un cuerpo cerrado detecta campos arrastrados por costumbre

Un cuerpo cerrado detecta campos arrastrados por costumbre

Aquí additionalProperties es false, así que el endpoint responde con un error de validación en cuanto una solicitud incluye una clave no definida. Los equipos que vienen de un endpoint de generación de video suelen arrastrar resolution, duration_seconds o prompt por costumbre, y esos campos vuelven como error antes de que exista una tarea; nada se descarta en silencio por el camino.

Cualquier MP4 funciona, sin importar su origen

Cualquier MP4 funciona, sin importar su origen

video_url no exige que el clip provenga de un modelo generativo. Una grabación de teléfono, una toma de stock con licencia, una captura de pantalla o un máster archivado pasan todos por el mismo campo, siempre que la toma muestre a un solo sujeto cuyo rostro se mantenga legible durante la mayor parte de su duración.

  • style es el único control de acabado

    Más allá de las dos URL de archivo, style es la única entrada opcional, y cambiar su valor no altera en nada cómo se arma la solicitud. realistic es el valor por defecto; beautify y lossless dan un acabado distinto al rostro intercambiado. Comparar los tres sobre un mismo par consiste en enviar el mismo cuerpo tres veces cambiando solo un valor.

  • El clip original decide la forma de salida

    No hay una escala de resolution ni un interruptor de aspect_ratio que pueda salir mal. Un clip vertical vuelve vertical, con sus propias dimensiones en píxeles, y la duración es la que se envió, así que el formato de entrega lo fija el archivo mismo, sin que ningún parámetro pueda desviarse de él.

  • Por cada llamada vuelve un solo video

    Una tarea completada entrega exactamente un activo de video, servido desde el almacenamiento de la plataforma, sin campo count ni por lotes para pedir más. La foto de referencia se lee y nada más: no se recorta, no se recodifica ni se devuelve, así que cada llamada deja exactamente un archivo nuevo que guardar de su lado.

  • Asíncrona desde la primera llamada

    Cada solicitud crea una tarea en lugar de bloquear a la espera de una respuesta, así que la integración consiste en enviar, guardar el ID de la tarea, consultar hasta que el estado se estabilice y luego obtener el resultado. La ventana de 1.800 segundos aplica por tarea, y el tiempo de procesamiento sigue la duración y la resolución del clip, así que los cortes breves se estabilizan antes que los largos.

Para quién es Video Face Swap

  • Un paso de postproceso que se coloca detrás de cualquier renderizador

    Ingenieros de pipeline

    Un paso de postproceso que se coloca detrás de cualquier renderizador

    Como video_url acepta cualquier MP4, este endpoint se conecta detrás de un modelo de video generativo, un grabador de pantalla o una exportación de cámara sin tener que distinguir cuál produjo el archivo. El punto de llamada se mantiene idéntico en los tres casos: dos URL, un style opcional, una tarea que consultar.

  • La profundidad de la cola importa más que la duración del clip

    Equipos de lotes y programación

    La profundidad de la cola importa más que la duración del clip

    Cada llamada es una solicitud en la factura y una tarea con su propia ventana de 1.800 segundos, así que la planificación de la cola depende de cuántos trabajos están en curso, no de su duración combinada. Cada tarea se consulta por su propio ID, lo que mantiene el bucle independiente de cuánto tarde un clip en concreto.

  • El material grabado mucho antes de este paso sigue siendo válido

    Equipos con una biblioteca de material ya existente

    El material grabado mucho antes de este paso sigue siendo válido

    Másteres archivados, tomas de stock con licencia y grabaciones de teléfono entran todos por el mismo campo video_url, sin más preparación que tener el archivo en MP4. Una toma cuya iluminación y movimiento de cámara ya fueron aprobados conserva ambos, porque el endpoint solo reemplaza los rasgos del rostro.

  • Un rostro generado evita contratar un segundo parecido real

    Estudios que trabajan con talento sintético

    Un rostro generado evita contratar un segundo parecido real

    reference_image_url no distingue si el rostro que contiene pertenece a una persona real, así que un rostro generado en otro lugar puede sostener una serie entera sin que un segundo parecido real entre en el proyecto. La cuestión de la autorización se reduce entonces al material filmado, que igualmente debe estar despejado.

Cómo llamar a la API de Video Face Swap

  1. Colocar ambos archivos donde el endpoint pueda obtenerlos

    video_url y reference_image_url son cadenas URL que el endpoint obtiene por sí mismo, no partes de archivo adjuntas a la llamada. El clip debe ser MP4; la foto de referencia puede ser JPEG, PNG o WebP.

  2. Construir el cuerpo con las tres claves definidas

    Envíe video_url, reference_image_url y, cuando el acabado por defecto no sea el correcto, style. Cualquier otra clave falla la validación porque additionalProperties es false, así que elimine los campos heredados de un payload de texto a video antes de enviar.

  3. Probar el emparejamiento primero en un corte breve

    Recorte unos segundos del material objetivo y ejecútelo antes del archivo completo. El tiempo de procesamiento crece con la duración y la resolución, así que una foto de referencia que no funciona se detecta antes en un corte breve.

  4. Enviar, guardar el ID de la tarea, luego consultar

    La llamada devuelve una tarea, no un video terminado. Guarde el ID devuelto y consúltelo hasta que el estado se estabilice o se cierre la ventana de 1.800 segundos, luego obtenga el video desde el almacenamiento de la plataforma.

  5. Reenviar con el clip completo una vez confirmado el resultado

    Reenvíe el mismo cuerpo con el archivo completo, cambiando solo video_url, de modo que la foto de referencia y el valor de style que produjeron la prueba aprobada sean los mismos que producen el render final.

Ejemplos resueltos con Video Face Swap

  • Una demostración de producto refundida con un segundo presentador

    Una demostración grabada en pantalla con un presentador en cámara pasa a ser la versión de un segundo presentador que dio su consentimiento. La grabación original va en video_url, la foto del nuevo presentador en reference_image_url, y el acabado realistic por defecto mantiene el tono de piel cercano al resto de la toma.

  • Un clip vertical de teléfono que vuelve vertical

    Una grabación en 9:16 hecha con un teléfono pasa sin cambiar de forma, porque no existe un campo aspect_ratio que pueda sobrescribir la que el archivo ya tiene. Lo que vuelve es el mismo encuadre y la misma duración, con el rostro como única diferencia entre los dos archivos.

  • Un recorte de diez segundos antes de un render largo

    Un corte breve de un video de formación largo confirma que la foto de referencia aguanta mientras el sujeto gira y se mueve, antes de enviar el archivo completo. Si el emparejamiento falla, el reintento cuesta unos segundos de procesamiento en lugar de todo el clip.

Preguntas sobre la API de Video Face Swap

Sin un prompt que escribir, el resultado depende por completo de los dos archivos. Elija una foto de referencia con el rostro despejado, casi de frente y con luz pareja, y un corte donde esa persona se vea grande en el encuadre. Hacer coincidir la dirección de la luz entre la foto y el material influye más en el resultado que cualquier campo de este esquema. Compruebe el emparejamiento en unos segundos, luego envíe el clip completo y cambie style solo si el acabado por defecto no es el correcto.

Modelos de esta serie4

Modelos de video1

  • Video Face SwapActualEdición de video$0.026por segundo de salida