Head Swap API

popnow/head-swap-v1/editDesde 2 créditos por imagen

Head Swap transfiere una cabeza completa desde una foto de referencia a la persona de una imagen objetivo, con forma de cráneo y peinado incluidos, y conserva el cuerpo, el vestuario, la pose y el fondo del objetivo. Dos URL y una seed opcional.

Llámalo con el nombre de modelo popnow/head-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.

  • Cambio de cara

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

Parámetros de la petición

ParámetroObligatorioDescripción
image_urlSíLa imagen de partida.
reference_image_urlSíReference head image. The whole head, including hair and head shape, is transferred onto the target.
seedNoRepite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647

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 Head 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/head-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/head-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"
  }
}'

# 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 Head Swap

¿Cuánto cuesta la API de Head Swap?

Head 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 Head Swap en la API?

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

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

Head Swap reemplaza la cabeza entera: cara, peinado, color de pelo y silueta del cráneo. Face Swap mueve solo los rasgos faciales y conserva el pelo propio del objetivo. Elige según si el pelo tiene que cambiar.

¿Qué imagen va en image_url?

La que se modifica: el cuerpo, el vestuario, la pose y el fondo que quieres conservar. reference_image_url aporta la cabeza. Intercambiarlas es una solicitud válida con un resultado completamente distinto y sin ningún error.

¿Hay prompt o máscara?

No. El esquema son image_url, reference_image_url y seed. No se redacta nada, así que el desenlace depende solo de las dos imágenes que elegiste.

¿Por qué se ve una línea en el cuello?

Ese es el principal modo de fallo del endpoint. Suele significar que las dos fuentes tienen direcciones de luz o tonos de piel distintos, o que el cuello del objetivo está tapado por un cuello alto, una bufanda o el pelo.

¿Importa lo que muestre la imagen?

No. El endpoint trata igual a cualquier objetivo, muestre lo que muestre. Lo que manda es el consentimiento: tienes que estar autorizado a poner esa imagen concreta en ese material concreto, y eso no se puede suponer a partir de una foto pública.

¿Puedo probar Head Swap sin escribir código?

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

Más sobre Head Swap