popnow
ConnexionCommencer à créer

Head Swap API

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

Head Swap transfère une tête entière depuis une photo de référence vers la personne d’une image cible, forme du crâne et coiffure comprises, en conservant le corps, la tenue, la pose et l’arrière-plan de la cible. Deux URL et une seed facultative.

Appelez-le avec le nom de modèle popnow/head-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 Head Swap →

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

Paramètres de requête

ParamètreRequisDescription
image_urlOuiL’image de départ.
reference_image_urlOuiReference head image. The whole head, including hair and head shape, is transferred onto the target.
seedNonLe 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.

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 Head 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/head-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/head-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"
  }
}'

# 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 Head Swap

Combien coûte l’API Head Swap ?

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

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

Quelle différence entre Head Swap et Face Swap ?

Head Swap remplace la tête entière — visage, coiffure, couleur de cheveux et silhouette du crâne. Face Swap ne déplace que les traits du visage et conserve les cheveux propres de la cible. Choisissez selon que la coiffure doit changer ou non.

Quelle image va dans image_url ?

Celle que l’on modifie — le corps, la tenue, la pose et l’arrière-plan que vous voulez garder. reference_image_url fournit la tête. Les intervertir donne une requête valide au résultat complètement différent, sans aucune erreur.

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

Non. Le schéma tient en image_url, reference_image_url et seed. Rien n’est formulé : le résultat ne dépend donc que des deux images que vous avez choisies.

Pourquoi une ligne visible apparaît-elle au cou ?

C’est le principal mode d’échec du point de terminaison. En général, cela signifie que les deux sources ont des directions de lumière ou des carnations différentes, ou que le cou de la cible est masqué par un col, une écharpe ou des cheveux.

Le contenu de l’image change-t-il quelque chose ?

Non. Le point de terminaison traite toutes les cibles de la même façon, quel que soit leur contenu. Ce qui gouverne, c’est le consentement : vous devez être autorisé à placer cette image précise dans ce matériel précis, et cela ne se déduit pas du fait qu’une photo soit publique.

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

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

En savoir plus sur Head Swap