Por ahora esta guía solo está en inglés. →
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 |
face_mapping | No | Multi-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. |
reference_image_url | Sí | Reference face image. The facial features from this image are carried onto the person in the video. |
style | No | Un estilo o género predefinido. realistic · beautify · lossless · Por defecto: realistic |
video_url | Sí | El clip con el que trabajar. |
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 segundo | ≈ USD |
|---|---|---|
| Estándar | 3,9 | 0,039 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 Video Face Swap 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-video-v1/video-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-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"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 Video Face Swap
¿Cuánto cuesta la API de Video Face Swap?
Video Face Swap cuesta 3,9 créditos (0,039 US$) por segundo. 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 Video Face Swap en la API?
Pon popnow/face-swap-video-v1/video-edit para Cambio de cara en vídeo en el campo model de POST /jobs/createTask.
¿En qué se diferencia de Face Swap?
Face Swap modifica una imagen fija. Video Face Swap aplica el mismo tipo de traspaso de rasgos a todo un clip, fotograma a fotograma. En ambos casos la referencia es una imagen fija.
¿Qué entrada va en cada campo?
video_url lleva el clip que se modifica y reference_image_url la foto que aporta la cara. Uno es video y el otro una imagen fija, así que no se pueden intercambiar por descuido.
¿Hay prompt, máscara o seed?
No. El esquema es video_url, reference_image_url y un style opcional. No hay nada que redactar ni zonas que pintar, lo que elimina toda una categoría de fallos por instrucciones ambiguas.
¿Qué style conviene elegir?
Empieza con realistic, el valor por defecto, que mantiene un tono y una textura de piel naturales. Beautify suaviza e ilumina la piel. Lossless conserva el máximo detalle de la cara de referencia y va bien en primeros planos.
¿Qué material funciona mejor?
Una sola persona en pantalla, con la cara bastante grande en el encuadre, luz uniforme y sin apartar la vista de la cámara durante mucho tiempo. Los perfiles marcados, el desenfoque por movimiento, las manos delante de la cara y las caras diminutas empeoran el resultado.
¿Puedo probar Video Face Swap sin escribir código?
Sí. El Playground ejecuta Video 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 Video Face Swap
- API de Face Swap ProCambio de cara preciso que conserva la textura natural de la pielDesde 24 créditos por imagen
- API de Face Swap PlusCambio de cara con ajuste automático del tono de pielDesde 24 créditos por imagen
- API de Face SwapCambia solo la cara; pelo, pose y fondo se quedan igualDesde 2 créditos por imagen
- API de Video Face SwapMantén la misma cara en cada fotograma del clipDesde 3,9 créditos por segundo
