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. |
mask_url | Non | Peignez la zone qui doit changer. |
output_format | Non | Le type de fichier du résultat. png · jpeg · webp · Par défaut: png |
prompt | Non | What to remove, in a few plain words with a position when there is more than one, e.g. "the wooden bench on the left". |
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 | 4,5 | 0,045 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 5 crédits par image (0,05 $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 Object Eraser 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/object-eraser-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/object-eraser-v1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "png"
}
}'
# 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 Object Eraser
Combien coûte l’API Object Eraser ?
Object Eraser coûte 5 crédits (0,05 $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 Object Eraser dans l’API ?
Indiquez popnow/object-eraser-v1/edit pour Gomme IA dans le champ model de POST /jobs/createTask.
Ai-je besoin d’un masque ?
Pas toujours. Une courte description suffit pour un objet bien distinct, avec de l’espace autour ; lors de nos tests, une louche en bois a disparu sur simple description. Les objets fins et ceux qui touchent le bord du cadre sont en revanche souvent ignorés, et la photo revient inchangée : un grand rack au bord de l’image est resté en place avec deux formulations différentes, puis a disparu du premier coup avec un masque. Envoyez mask_url quand une description ne prend pas, ou pour ne retirer qu’un seul de deux objets semblables.
Et si ma description ne correspond à rien ?
Vous récupérez la photo inchangée et la requête compte comme aboutie. Nommez un élément réellement présent dans l’image, et ajoutez une position s’il y en a plusieurs.
À quoi doit ressembler le masque ?
À la taille de la photo, blanc sur ce qui doit disparaître et noir partout ailleurs. Peignez un peu au-delà du bord de l’objet pour que son contour et son ombre partent aussi.
Peut-il ajouter quelque chose dans le vide ?
Non. Il supprime et comble l’espace avec un environnement assorti.
Quelles sont les limites de l’API Object Eraser ?
Longueur du prompt (caractères): 1,000. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Object Eraser sans écrire de code ?
Oui. Le Playground lance Object Eraser avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.