Retirer le fondÀ propos de Background Remover
Détourez le sujet principal de n’importe quelle photo en un seul appel : le fond devient entièrement transparent, dans un PNG aux dimensions de votre fichier.
Appelez-le avec le nom de modèle popnow/background-remover-v1/edit sur POST /jobs/createTask, à partir de 1 crédit par image (0,01 $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ètre | Requis | Description |
|---|---|---|
image_url | Oui | L’image de départ. |
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 | 0,72 | 0,0072 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 1 crédit par image (0,01 $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 Background Remover 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/background-remover-v1/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/background-remover-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.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 Background Remover
Combien coûte l’API Background Remover ?
Background Remover coûte 1 crédit (0,01 $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 Background Remover dans l’API ?
Indiquez popnow/background-remover-v1/edit pour Retirer le fond dans le champ model de POST /jobs/createTask.
Dois-je décrire le sujet ?
Non. Le endpoint ne prend qu’un champ, image_url, et choisit lui-même le premier plan. Si la photo contient plusieurs candidats, recadrez d’abord sur celui que vous voulez.
Que reçois-je en retour ?
Un PNG à fond transparent, à la même largeur et à la même hauteur que l’image envoyée, que vous pouvez superposer directement à l’original.
Peut-il mettre un nouveau fond ?
Pas dans le même appel : il ne fait que supprimer. Posez le PNG sur votre propre couleur ou photo, ou construisez une nouvelle scène avec Image Expander et superposez-y le détourage.
Quelles photos donnent les meilleurs résultats ?
Un sujet net qui se détache de son environnement par la couleur ou la lumière. Les contours peu contrastés, le flou de bougé et les sujets coupés par le cadre sont les points faibles.
Puis-je essayer Background Remover sans écrire de code ?
Oui. Le Playground lance Background Remover avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.