Étendre l’imageÀ propos de Image Expander
Élargissez une photo vers un nouveau format : un décor nouveau est peint autour de l’original au lieu de le recadrer ou de l’étirer.
Appelez-le avec le nom de modèle popnow/image-expander-v1/edit sur POST /jobs/createTask, à partir de 4 crédits par image (0,04 $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 |
|---|---|---|
aspect_ratio | Non | La forme du cadre : large, carrée ou verticale. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · Par défaut: 1:1 |
image_url | Oui | L’image de départ. |
output_format | Non | Le type de fichier du résultat. png · jpeg · webp · Par défaut: png |
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 | 3,6 | 0,036 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 4 crédits par image (0,04 $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 Image Expander 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/image-expander-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/image-expander-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"aspect_ratio": "1:1",
"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 Image Expander
Combien coûte l’API Image Expander ?
Image Expander coûte 4 crédits (0,04 $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 Image Expander dans l’API ?
Indiquez popnow/image-expander-v1/edit pour Étendre l’image dans le champ model de POST /jobs/createTask.
Puis-je indiquer ce qui doit apparaître dans la nouvelle zone ?
Non. Il n’y a pas de champ de prompt ; l’extension prolonge ce qui figure déjà sur la photo.
Quelle est la taille du résultat ?
Le grand côté mesure toujours 1536 pixels et le petit côté suit le format choisi : 1536 × 864 en 16:9, 864 × 1536 en 9:16, 1536 × 1536 en 1:1.
Quel format choisir ?
Celui de votre destination : 16:9 pour les couvertures vidéo et les en-têtes, 9:16 pour les stories et les reels, 1:1 pour les fils d’actualité et les vignettes de places de marché, 3:2 ou 2:3 pour les mises en page de type impression.
Quelles sont les limites de l’API Image Expander ?
Formats d’image: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Image Expander sans écrire de code ?
Oui. Le Playground lance Image Expander avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.