popnow
ConnexionCommencer à créer

popnow/face-swap-v1/editÀ partir de 2 crédits par image

Face Swap prend une image cible et un visage de référence, et ne transfère que les traits du visage : la forme du crâne, la coiffure, la pose et l’arrière-plan de la cible restent en place. Deux URL et une seed facultative — il n’y a aucun champ prompt à rédiger.

Appelez-le avec le nom de modèle popnow/face-swap-v1/edit sur POST /jobs/createTask, à partir de 2 crédits par image (0,02 $US). Les nouveaux comptes reçoivent 30 crédits gratuits pour l’essayer d’abord dans le Playground.

  • Échange de visage
par PopNowObtenir une clé APIExemples et prompts Face Swap →

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

Paramètres de requête

ParamètreRequisDescription
face_enhanceNonRun a face-enhancement pass on the swapped face for a sharper, more detailed result. Par défaut: false
face_mappingNonMulti-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.
image_urlOuiL’image de départ.
reference_image_urlOuiReference face image. The facial features from this image are transferred onto the target.
seedNonLe même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647
styleNonUn look ou un genre prédéfini. realistic · beautify · lossless · Par défaut: realistic

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.

OptionCrédits par image≈ USD
Standard1,950,02 $US

Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 2 crédits par image (0,02 $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 en trois étapes

  1. 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.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model popnow/face-swap-v1/edit et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. 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/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "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"

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

Combien coûte l’API Face Swap ?

Face Swap coûte 2 crédits (0,02 $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 dans l’API ?

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

Quelle différence entre Face Swap et Head Swap ?

Face Swap ne déplace que les traits du visage et conserve la coiffure et la forme de crâne de la cible. Head Swap remplace toute la tête, cheveux et silhouette compris. Choisissez selon que la coiffure doit changer ou non.

Quelle image mettre dans image_url ?

Celle que l’on modifie. reference_image_url fournit le visage. Les deux ne sont pas interchangeables, et les intervertir reste valide mais produit un résultat complètement différent — aucune erreur ne vient l’attraper.

Y a-t-il un prompt ou un masque ?

Non. Le schéma tient en image_url, reference_image_url et seed. Rien à formuler, aucune zone à peindre — c’est toute une classe d’échecs par instruction ambiguë qui disparaît.

Quel type de photos fonctionne le mieux ?

Des visages nettement visibles, raisonnablement de face, bien éclairés et de taille correcte dans le cadre, avec une direction de lumière proche dans les deux images. Profils, flou de bougé, occlusions marquées et tout petits visages sont là où ça se dégrade.

Peut-il gérer plusieurs visages sur une photo ?

Non. Un visage par image est l’hypothèse de travail, et une photo de groupe ne donne au point de terminaison aucun moyen de savoir de quelle personne il s’agit. Recadrez sur le sujet avant d’envoyer.

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

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

Tous les modèles Face Swap

En savoir plus sur Face Swap