API Face Swap Plus : prix, paramètres et code

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

Ce guide n'est disponible qu'en anglais pour le moment. →

Paramètres de requête

Paramètre	Requis	Description
`image_url`	Oui	L’image de départ.
`output_format`	Non	Le type de fichier du résultat. png · jpeg · webp · Par défaut: jpeg
`output_quality`	Non	Requested image quality for the result, from 10 to 100. ≥ 10 · ≤ 100 · Par défaut: 95
`prompt`	Non	Optional short note guiding one subtle attribute of the result, such as an accessory, an expression or a different hairstyle.
`reference_image_url`	Oui	Reference face image. The facial identity from this image is transferred onto the target.
`seed`	Non	Le même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647

Tarifs

Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.

Option	Crédits par image	≈ USD
Standard	24	0,24 $US

Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.

Démarrage rapide de l'API

Appeler l’API Face Swap Plus en trois étapes

Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
Envoyer la requête. Envoyez POST /jobs/createTask avec model popnow/face-swap-v1-plus/edit et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.

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

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API Face Swap Plus

Combien coûte l’API Face Swap Plus ?

Face Swap Plus coûte 24 crédits (0,24 $US) par image. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.

Quel est le nom de modèle de Face Swap Plus dans l’API ?

Indiquez popnow/face-swap-v1-plus/edit pour Échange de visage dans le champ model de POST /jobs/createTask.

Quelle image va dans image_url ?

Celle qui est modifiée. reference_image_url fournit le visage. Les deux ne sont pas interchangeables, et les intervertir reste une requête valide avec un résultat complètement différent : aucune erreur ne rattrapera la confusion.

Il existe un champ `prompt`. Fait-il quelque chose ?

Dans nos propres tests, non. Le 20/09/2026, nous avons passé cinq appels réels sur ce point de terminaison — deux demandant des lunettes de soleil, un une autre coiffure, deux une expression différente — et chaque résultat était indiscernable de la même requête avec le champ vide. Le modèle accepte la valeur et ne renvoie ni erreur ni avertissement : un appel qui s’y fie a donc l’air d’avoir fonctionné. Considérez le champ comme inerte et ne l’envoyez pas.

Fixer le seed garantit‑il un résultat identique ?

Non. Il donne à deux exécutions sur la même paire le même tirage, ce qui rend la comparaison honnête quand vous changez une seule chose. C’est un outil de comparaison, pas une promesse d’image identique au bit près.

À quoi doivent ressembler les deux images ?

Un seul visage bien visible sur chacune, à peu près de face, net et assez grand dans le cadre pour que les traits soient lisibles, en JPEG, PNG ou WebP. Recadrez une photo de groupe sur une seule personne avant l’envoi. La carnation est accordée pour vous, mais pas la direction de la lumière : une référence éclairée à peu près du même côté que la cible donne donc toujours la mâchoire la plus propre.

Quelles sont les limites de l’API Face Swap Plus ?

Longueur du prompt (caractères): 200. Les requêtes hors de ces limites sont refusées avant tout débit.

Puis-je essayer Face Swap Plus sans écrire de code ?

Oui. Le Playground lance Face Swap Plus avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.

Tous les modèles Face Swap Plus

En savoir plus sur Face Swap Plus

Essayer: Face Swap Plus : échange de visage IA en ligne Créer des images avec Face Swap Plus dans PopNow
Docs: ID de modèle et schéma d’entrée de Face Swap Plus dans la doc API Démarrage rapide de l’API PopNow : votre première requête en cinq minutes Guide de génération d’images avec l’API PopNow Webhooks : recevez les résultats de Face Swap Plus sans polling