API de Face Swap Plus: precios, parámetros y código

Name: Face Swap Plus API
SKU: popnow/face-swap-v1-plus/edit
Price: 0.24 USD
Availability: InStock

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

Parámetros de la petición

Parámetro	Obligatorio	Descripción
`image_url`	Sí	La imagen de partida.
`output_format`	No	Tipo de archivo del resultado. png · jpeg · webp · Por defecto: jpeg
`output_quality`	No	Requested image quality for the result, from 10 to 100. ≥ 10 · ≤ 100 · Por defecto: 95
`prompt`	No	Optional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle.
`reference_image_url`	Sí	Reference face image. The facial identity from this image is transferred onto the target.
`seed`	No	Repite 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ón	Créditos por imagen	≈ USD
Estándar	24	0,24 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 Plus en tres pasos

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.
Envía la solicitud. Haz POST /jobs/createTask con model popnow/face-swap-v1-plus/edit y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
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-plus/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
    "output_format": "jpeg"
  }
}'

# 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 Plus

¿Cuánto cuesta la API de Face Swap Plus?

Face Swap Plus cuesta 24 créditos (0,24 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 Plus en la API?

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

¿Qué imagen va en image_url?

La que se modifica. reference_image_url aporta el rostro. Las dos no son intercambiables, e invertirlas sigue siendo una solicitud válida con un resultado completamente distinto, así que ningún error atrapará la confusión.

Hay un campo `prompt`. ¿Hace algo?

En nuestras propias pruebas, no. El 20/09/2026 lanzamos cinco llamadas reales a este endpoint —dos pidiendo gafas de sol, una un peinado distinto y dos una expresión diferente— y todos los resultados fueron indistinguibles de la misma solicitud con el campo vacío. El modelo acepta el valor y no devuelve error ni aviso, así que una llamada que dependa de él parece haber funcionado. Trate el campo como inerte y no lo envíe.

¿Fijar el seed garantiza un resultado idéntico?

No. Le da a dos corridas sobre el mismo par el mismo sorteo, lo que vuelve justa la comparación cuando usted cambia una sola cosa. Es una herramienta de comparación, no una promesa de una imagen idéntica al byte.

¿Cómo deben ser las dos imágenes?

Un solo rostro claramente visible en cada una, más o menos de frente, enfocado y lo bastante grande en el encuadre para que los rasgos se lean, en JPEG, PNG o WebP. Recorta una foto de grupo a una sola persona antes de enviarla. El tono de piel se concilia por ti, pero la dirección de la luz no, así que una referencia iluminada más o menos desde el mismo lado que el destino sigue dando la mandíbula más limpia.

¿Qué límites tiene la API de Face Swap Plus?

Longitud del prompt (caracteres): 200. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.

¿Puedo probar Face Swap Plus sin escribir código?

Sí. El Playground ejecuta Face Swap Plus 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 Plus

Más sobre Face Swap Plus

Pruébalo: Face Swap Plus: cambio de cara con IA en línea Crea imágenes con Face Swap Plus en PopNow
Documentación: ID de modelo y esquema de entrada de Face Swap Plus en la documentación de la API Inicio rápido de la API de PopNow: tu primera solicitud en cinco minutos Guía de generación de imágenes con la API de PopNow Webhooks: recibe los resultados de Face Swap Plus sin sondeos