Ir al contenido principal

Sin censura — Este modelo declara que no aplica filtros. SpicyAPI reenvía sin añadir análisis de contenido de la plataforma; las obligaciones legales y de consentimiento siguen siendo del cliente.Ver todos los modelos con este nivel de filtrado
spicyapi/face-swap-v1/edit

Face Swap es el intercambio de rostros de SpicyAPI para imágenes. Transfiere solo los rasgos faciales de una foto de referencia a una imagen de destino, conservando su cabeza, peinado, pose y fondo. Envía dos URL de imagen y una semilla opcional; sin prompt.

Desde $0.013/imagen
Ejecutar modelo

Playground

Entrada

Edición de imagen
1/1

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

  • 1
1 / 1 archivos
La imagen que se modifica. La forma de cabeza, el peinado, la pose, el vestuario y el fondo de esa persona se conservan: solo se reemplazan sus rasgos faciales. 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
La imagen que aporta los rasgos faciales. Solo se toma la cara, no la forma de la cabeza ni el pelo. Elige una iluminada más o menos desde la misma dirección que el objetivo. mínimo 1 caracteres
Correspondencia de rostros0/10
Para fotos de grupo: indica qué rostro de la referencia va sobre qué rostro del destino, 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
Estilo
realisticbeautifylossless
Acabado del rostro intercambiado: realistic (por defecto) conserva el tono y la textura naturales de la piel, beautify la suaviza e ilumina, lossless conserva el máximo detalle facial. No cambia el costo.
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.
Seed
Reutiliza una seed para comparar dos corridas sobre el mismo par de imágenes contra un sorteo idéntico; déjala vacía o en 0 para un sorteo aleatorio cada vez. Es una herramienta de comparación, no la garantía de un resultado idéntico. no menor que 0 · no mayor que 2147483647
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
silver-bob-recastResultado de ejemplo
Animar
Editar
Separar en capas

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.

Un esquema estricto de tres campos, una imagen de vuelta

La API de edición de Face Swap toma una imagen objetivo en image_url y un rostro para transferir en reference_image_url, y devuelve una imagen con los rasgos faciales trasladados. seed es el único otro campo que acepta el esquema; cualquier otra clave en el cuerpo falla la validación. Cada campo de imagen admite una URL HTTPS pública, un URI de archivo subido o un URI de datos incrustado.

Abrir el Playground
Un esquema estricto de tres campos, una imagen de vuelta
Campos obligatorios
image_url (el objetivo) y reference_image_url (el rostro)
Campo opcional
seed, un entero de 0 a 2.147.483.647
Cómo se envían las imágenes
URL HTTPS pública, URI de archivo subido o URI de datos incrustado
Formatos aceptados
JPEG, PNG o WebP en cualquiera de los dos campos de imagen
Plazo de la tarea
1.800 segundos, tras los cuales la tarea expira
Facturación
Por imagen generada, un solo nivel de precio, sin variantes que elegir
Validación
Los campos desconocidos detienen la solicitud antes de que se convierta en tareaEl esquema define tres campos y fija additionalProperties en false, así que una clave sobrante del payload de otro modelo (un valor de strength, una cadena de prompt) vuelve como un 400 que nombra el campo rechazado. No se encola nada, y nada se descarta en silencio por el camino.
Seed
seed cubre todo el rango de 32 bits con signoSe acepta cualquier entero de 0 a 2.147.483.647. Pasar el mismo valor dos veces sobre el mismo par de imágenes mantiene el sorteo lo bastante estable como para comparar dos ejecuciones, que es para lo que sirve el campo; no promete que ambas imágenes vuelvan idénticas. Si se omite, el sorteo es aleatorio.
Plazo
1.800 segundos es el tope, no la espera esperadaCada tarea lleva un plazo de 1.800 segundos desde que se acepta, que aparece en el registro de la tarea como deadlineAt. Una tarea que lo alcanza termina como expired en vez de devolver una imagen. Dimensiona el bucle de sondeo con ese número, no con una estimación al azar para un par de fotos.

En qué destaca la API de Face Swap

Todo el cuerpo de la solicitud son tres claves

Todo el cuerpo de la solicitud son tres claves

image_url y reference_image_url son obligatorios, seed es opcional, y esa es la lista completa. No hay ningún control de strength que calibrar ni ninguna región que pintar, así que la misma forma de solicitud sirve tanto para un retrato de estudio como para un plano de cuerpo entero, y un proceso por lotes solo tiene que variar dos URL por tarea.

El formato se elige de forma independiente entre las dos imágenes

El formato se elige de forma independiente entre las dos imágenes

image_url y reference_image_url aceptan cada uno JPEG, PNG o WebP por su cuenta, así que un objetivo en WebP con un rostro de referencia en JPEG es tan válido como un par que coincida, y ningún archivo necesita convertirse antes de la llamada. La forma de enviar cada uno también es independiente.

  • Un campo de imagen admite un enlace, una subida o bytes incrustados

    Un enlace HTTPS público no necesita ninguna llamada adicional. Un archivo también puede subirse primero a la plataforma, con un ticket de subida y una confirmación, y luego referenciarse con el URI que devuelve. Las imágenes pequeñas pueden viajar incrustadas como URI de datos, hasta 1.048.576 bytes decodificados y 8.192 píxeles por lado.

  • Una tarea, una imagen

    Una tarea terminada expone un único recurso de imagen desde el almacenamiento de la plataforma, y el esquema no tiene ningún campo count o batch para pedir más. Diez pares de fotos significan diez tareas, cada una con su propio ID y estado de sondeo, lo que evita que un fallo en un par bloquee las otras nueve.

  • seed se justifica en las repeticiones

    Omitir seed, o enviar 0, saca un valor nuevo en cada llamada. Fijarlo importa cuando una ejecución posterior sobre el mismo par debe compararse con una anterior, por ejemplo tras cambiar a una foto de referencia mejor iluminada. Las llamadas de una sola vez pueden saltarse el campo por completo.

  • Sondea la tarea o deja que te avisen

    Toda solicitud es asíncrona: crear la tarea devuelve un ID de tarea en estado queued. A partir de ahí, sondea la tarea hasta que se resuelva, o pasa callBackUrl en la solicitud de creación y recibe la entrega final ahí en su lugar. Esa URL tiene que ser HTTPS pública, porque la entrega lleva enlaces de resultado firmados.

Para quién es Face Swap

  • Un esquema lo bastante pequeño para escribirlo directo en el código, sin plantillas

    Ingenieros de integración backend

    Un esquema lo bastante pequeño para escribirlo directo en el código, sin plantillas

    Con solo image_url, reference_image_url y seed que rellenar, el cuerpo de la solicitud no necesita un motor de plantillas ni una lista dinámica de campos: tres variables mapeadas directamente en un objeto JSON cubren cualquier llamada que acepta este endpoint.

  • Probar un look sobre tomas que ya están iluminadas y encuadradas

    Equipos de e-commerce y catálogo

    Probar un look sobre tomas que ya están iluminadas y encuadradas

    La fotografía de producto existente (el ajuste de la prenda, la pose, el fondo) se mantiene intacta en image_url mientras reference_image_url introduce el rostro de otro modelo, lo que evita reservar una nueva sesión solo para ver cómo queda una ficha con otra persona delante de la cámara.

  • Un mismo rostro trasladado a fotogramas generados en otro lugar

    Plataformas de personajes y avatares

    Un mismo rostro trasladado a fotogramas generados en otro lugar

    Un conjunto de escenas producidas por otro modelo de imagen puede compartir una identidad después, aplicando el mismo reference_image_url a cada fotograma por turno, una tarea por par, y fijando seed cuando una repetición debe coincidir con un lote anterior.

  • Publicar una imagen sin el rostro real del sujeto

    Flujos de privacidad y anonimización

    Publicar una imagen sin el rostro real del sujeto

    Cuando una foto objetivo puede publicarse pero la identidad real de la persona no debe revelarse, reference_image_url puede apuntar a un rostro sustituto sintético o autorizado en lugar de la imagen de una segunda persona real. Las reglas de autorización de las preguntas frecuentes de abajo siguen rigiendo ambas imágenes.

Cómo llamar a la API de Face Swap

  1. Decide cómo llega cada imagen al endpoint

    image_url y reference_image_url son cadenas de texto, así que cada una necesita un enlace HTTPS público, un URI de archivo procedente de una subida a la plataforma o un URI de datos incrustado en la solicitud. JPEG, PNG y WebP se aceptan en cualquiera de los dos campos.

  2. Envía solo los campos que define el esquema

    Construye el cuerpo con image_url, reference_image_url y, si lo necesitas, seed. Cualquier otra clave falla la validación porque additionalProperties es false, así que elimina los restos del payload de otro endpoint antes de enviarlo.

  3. Haz una prueba en seco de una integración nueva con un quote

    El endpoint de quote ejecuta las mismas comprobaciones de validación de entrada y de admisión que la creación de la tarea, sin crear una tarea ni reservar fondos, y el quote firmado que devuelve es válido durante cinco minutos. Es la forma más rápida de confirmar que el cuerpo de una solicitud tiene la forma correcta.

  4. Envía, y luego sondea o recibe el callback

    Envía la solicitud y guarda el ID de tarea que devuelve. Sondea hasta que la tarea alcance un estado terminal, o registra callBackUrl y espera la entrega. Una Idempotency-Key hace que un reintento devuelva la tarea original en lugar de crear una segunda.

  5. Recupera la única imagen de salida

    Una tarea exitosa expone un único recurso de imagen servido desde el almacenamiento de la plataforma. No hay ningún campo count, así que más salidas significan más tareas: una por cada par de objetivo y referencia, cada una sondeada y cobrada por separado.

Ejemplos resueltos con Face Swap

  • Un recast de producto el mismo día

    Un retailer ya tiene una toma de producto completamente iluminada de un modelo y necesita la misma toma para mostrar a un segundo modelo autorizado en su lugar. image_url conserva la fotografía original y reference_image_url apunta al retrato del segundo modelo; la tarea devuelve una imagen con la pose, la prenda y la iluminación intactas.

  • Un lote de diez fotogramas de avatar que comparten una identidad

    Diez fotogramas objetivo generados por separado con un modelo de imagen reciben, por turnos, el mismo reference_image_url: diez tareas, un rostro compartido. Fijar un único valor de seed en todo el lote hace que repetir cualquier fotograma sea comparable con su primera pasada.

  • Un proceso por lotes que sobrevive a una conexión caída

    Cada par se envía con una Idempotency-Key derivada de los dos ID de origen. Si la conexión se cae a mitad del envío y el proceso reintenta, la clave devuelve la tarea original en lugar de abrir una segunda, así que un lote reiniciado no paga dos veces por un par que ya había enviado.

Preguntas sobre la API de Face Swap

No hay ningún prompt que escribir, así que la mayor parte del trabajo de integración está en las entradas y la fontanería. Decide pronto cómo llegan las imágenes al endpoint: un enlace HTTPS no necesita ninguna llamada adicional, una subida necesita un ticket y una confirmación, y un URI de datos tiene que quedarse por debajo de 1.048.576 bytes decodificados. Pasa el primer cuerpo por un quote antes de gastar una llamada real en él, conserva seed para las repeticiones que planees comparar, y envía una Idempotency-Key en cada creación.

Modelos de esta serie4

Modelos de imagen3

Modelos de video1