PopNowAPI
Obtenir une clé API

par PopNow

Restaure jusqu’à trois visages d’une photo, résolution inchangée

popnow/face-enhancer-v1/edit
  • Amélioration de visages

À propos de Face Enhancer

Face Enhancer restaure et affine jusqu’à trois visages d’une photo, du plus grand au plus petit. Rien d’autre dans l’image ne change, la résolution reste la même, et le résultat est livré en JPEG, PNG ou WebP. Aucun prompt à écrire.

Appelez-le avec le nom de modèle popnow/face-enhancer-v1/edit sur POST /jobs/createTask, à partir de 0,012 $US.

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

Paramètres de requête

ParamètreRequisDescription
image_urlOuiL’image de départ.
output_formatNonLe type de fichier du résultat. jpeg · png · webp · Par défaut: jpeg

Tarifs

Les prix sont en USD. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

OptionUSD par image
Standard0,012 $US

Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.

Démarrage rapide de l'API

Appeler l’API Face Enhancer 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-. Les appels API utilisent votre solde distinct en dollars américains.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model popnow/face-enhancer-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-enhancer-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.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 Enhancer

Combien coûte l’API Face Enhancer ?

Face Enhancer coûte 0,012 $US par image. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

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

Indiquez popnow/face-enhancer-v1/edit pour Amélioration de visages dans le champ model de POST /jobs/createTask.

L’outil agrandit-il ma photo ?

Non. Le résultat revient à la résolution que vous envoyez : notre photo de test de 720×404 est revenue en 720×404. Pour plus de pixels, utilisez Image Upscaler sur /models/image-upscaler-v1.

Combien de visages sont restaurés ?

Jusqu’à trois, du plus grand au plus petit. Les autres visages de la photo restent tels quels, comme tout ce qui se trouve hors des visages.

La personne reste-t-elle reconnaissable ?

Dans nos tests, les visages sont restés reconnaissables comme les mêmes personnes. Les détails sont reconstitués : comparez donc le résultat avec votre original avant de le publier.

Qu’est-ce qui reste intact, et qu’est-ce qui est adouci ?

L’arrière-plan n’est pas modifié : dans notre test, l’étagère de bouteilles derrière le sujet a gardé ses blocs de compression d’origine. La peau du visage est revenue un peu plus lisse qu’elle ne le serait sur une vraie photo.

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

Exécutez Face Enhancer dans le Playground avec votre solde API en USD, sans clé API. Chaque exécution figure dans votre historique développeur avec le code correspondant.

Tous les modèles Face Enhancer

Image Upscaler agrandit toute l’image ; Face Enhancer corrige les visages à taille égale.

En savoir plus sur Face Enhancer