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

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

Parámetros de la petición

Parámetro	Obligatorio	Descripción
`face_enhance`	No	Run a face-enhancement pass on the swapped face for a sharper, more detailed result. Por defecto: false
`image_url`	Sí	La imagen de partida.
`reference_image_url`	Sí	Reference face image. The facial features from this image are transferred onto the target.

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 Pro 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-pro-v1/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-pro-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 Face Swap Pro

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

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

Pon popnow/face-swap-pro-v1/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 prompt o máscara?

No. La solicitud son dos URL de imagen. No hay nada que redactar ni ninguna zona que pintar, lo que elimina toda una clase de fallas causadas por una instrucción ambigua.

¿Por qué aquí no puedo fijar un seed?

El motor detrás de este endpoint no lo recibe, así que exponer el campo sería publicar un control que nada puede cumplir. Cuando necesite que dos corridas sobre el mismo par queden comparables, tanto Face Swap como Face Swap Plus aceptan un seed.

¿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. La palanca más útil es la dirección de la luz: una referencia iluminada más o menos desde el mismo lado que el destino evita la costura en la mandíbula, porque el intercambio no cambia la luz del destino.

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

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

Otras API de imagen

Más sobre Face Swap Pro

Pruébalo: Face Swap Pro: cambio de cara con IA en línea Crea imágenes con Face Swap Pro en PopNow
Documentación: ID de modelo y esquema de entrada de Face Swap Pro 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 Pro sin sondeos