Obtenir une clé API

par PopNow

Échange de visage précis qui garde une texture de peau naturelle

popnow/face-swap-pro-v1/editÀ partir de 24 créditspar image · 0,24 $US
  • Échange de visage

À propos de Face Swap Pro

Face Swap Pro est le niveau de précision de la gamme Face Swap : il repère les points caractéristiques du visage sur les deux photos et fait correspondre le visage par ces points, et aucune passe d’embellissement ne repasse sur le résultat, si bien que la texture d’origine survit. La requête entière tient en deux URL d’image, rien à formuler ni à régler, et une image revient par appel, facturée à l’image produite.

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

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
image_urlOuiL’image de départ.
reference_image_urlOuiReference face image. The facial features from this image are transferred onto the target.

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
Standard240,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 Pro 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-pro-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-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"

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 Pro

Combien coûte l’API Face Swap Pro ?

Face Swap Pro 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 Pro dans l’API ?

Indiquez popnow/face-swap-pro-v1/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.

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

Non. La requête tient en deux URL d’images. Rien à formuler, aucune zone à peindre, ce qui supprime toute une catégorie d’échecs dus à une consigne ambiguë.

Pourquoi ne puis‑je pas fixer de seed ici ?

Le moteur derrière cet endpoint n’en accepte pas ; exposer le champ reviendrait à afficher un réglage que rien ne peut honorer. Quand deux exécutions sur une même paire doivent rester comparables, Face Swap et Face Swap Plus acceptent tous deux un seed.

À 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. Le levier le plus utile est la direction de la lumière : une référence éclairée à peu près du même côté que la cible évite la couture à la mâchoire, car l’échange ne change pas la lumière de la cible.

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

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

Tous les modèles Face Swap Pro

En savoir plus sur Face Swap Pro