PopNow APIpopnow.ai
Consigue tu clave API

de PopNow

Cambia solo la cara; pelo, pose y fondo se quedan igual

popnow/face-swap-v1/editDesde 2 créditospor imagen · 0,02 US$
Pruébalo en el PlaygroundObtener clave API
  • Cambio de cara

Acerca de Face Swap

Face Swap toma una imagen objetivo y una cara de referencia y transfiere solo los rasgos faciales: la forma de la cabeza, el peinado, la pose y el fondo del objetivo se quedan como están. Dos URL y una seed opcional; no hay campo de prompt que escribir.

Llámalo con el nombre de modelo popnow/face-swap-v1/edit en POST /jobs/createTask, desde 2 créditos por imagen (0,02 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.

Por ahora esta guía solo está en inglés. →

Parámetros de la petición

ParámetroObligatorioDescripción
face_enhanceNoRun a face-enhancement pass on the swapped face for a sharper, more detailed result. Por defecto: false
face_mappingNoMulti-person swap: which face in the reference image goes onto which face in the target, one entry per face. Faces are numbered from 0 in detection order.
image_urlSíLa imagen de partida.
reference_image_urlSíReference face image. The facial features from this image are transferred onto the target.
seedNoRepite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647
styleNoUn estilo o género predefinido. realistic · beautify · lossless · Por defecto: realistic

Precios

Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.

OpciónCréditos por imagen≈ USD
Estándar1,950,02 US$

Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 2 créditos por imagen (0,02 US$).

Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.

Inicio rápido de la API

Llama a la API de Face Swap en tres pasos

  1. Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
  2. Envía la solicitud. Haz POST /jobs/createTask con model popnow/face-swap-v1/edit y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
  3. Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "popnow/face-swap-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
    "style": "realistic"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.

Preguntas sobre la API de Face Swap

¿Cuánto cuesta la API de Face Swap?

Face Swap cuesta 2 créditos (0,02 US$) por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.

¿Cuál es el nombre de modelo de Face Swap en la API?

Pon popnow/face-swap-v1/edit para Cambio de cara en el campo model de POST /jobs/createTask.

¿Qué diferencia hay entre Face Swap y Head Swap?

Face Swap mueve solo los rasgos faciales y conserva el peinado y la forma de cabeza del objetivo. Head Swap reemplaza la cabeza entera, con pelo y silueta incluidos. Elige según si el pelo tiene que cambiar.

¿Qué imagen va en image_url?

La que se modifica. reference_image_url aporta la cara. Las dos no son intercambiables, e intercambiarlas es válido pero da un resultado completamente distinto: no hay error que lo atrape.

¿Hay prompt o máscara?

No. El esquema son image_url, reference_image_url y seed. No hay nada que redactar ni región que pintar, y eso elimina toda una clase de fallos por instrucción ambigua.

¿Qué tipo de fotos funciona mejor?

Caras claramente visibles, razonablemente frontales, bien iluminadas y de buen tamaño en el cuadro, con una dirección de luz parecida en ambas imágenes. Perfiles, trepidación, oclusión fuerte y caras diminutas son donde se degrada.

¿Puede manejar más de una cara en una foto?

No. Una cara por imagen es el supuesto de trabajo, y una foto de grupo no le da al endpoint forma de saber a qué persona te referías. Recorta al sujeto antes de mandarla.

¿Puedo probar Face Swap sin escribir código?

Sí. El Playground ejecuta Face Swap con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.

Todos los modelos de Face Swap

Más sobre Face Swap