Agrandir l’imageÀ propos de Image Upscaler
Agrandissez une image finalisée en 2K, 4K ou 8K en un seul appel. Envoyez l’image et choisissez un palier de taille : la composition reste exactement la même, et il n’y a aucun prompt à écrire.
Appelez-le avec le nom de modèle popnow/image-upscaler-v1/upscale 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.
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. |
output_format | Non | Le type de fichier du résultat. jpeg · png · webp · Par défaut: jpeg |
resolution | Non | Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 2k · 4k · 8k · Par défaut: 4k |
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 | 1,8 | 0,018 $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 Image Upscaler 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-upscaler-v1/upscale 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-upscaler-v1/upscale",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "4k",
"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 Image Upscaler
Combien coûte l’API Image Upscaler ?
Image Upscaler 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 Image Upscaler dans l’API ?
Indiquez popnow/image-upscaler-v1/upscale pour Agrandir l’image dans le champ model de POST /jobs/createTask.
Que signifient 2k, 4k et 8k ?
Ce sont des budgets de pixels, pas des formats fixes : l’image garde son rapport d’aspect et passe à environ 4, 17 ou 67 mégapixels. Une photo de 1024×1536 est revenue en 1672×2508, 3344×5017 et 6689×10033.
Mon image peut-elle devenir plus petite ?
Oui, si le palier est inférieur à la source. Une image de 3344×5017 envoyée en 2k est revenue en 1672×2509. Choisissez un palier au-dessus du nombre de pixels actuel de votre image.
Le contenu de l’image change-t-il ?
Non. La composition, les couleurs et le sujet restent tels qu’envoyés ; les contours et les textures sont affinés et les détails fins complétés. Pour modifier le contenu, passez d’abord par un modèle d’édition et agrandissez le résultat en dernier.
Quel format de sortie choisir ?
jpeg, le format par défaut, garde des fichiers raisonnables : notre test en 8k pesait environ 8 Mo. png est sans perte mais plusieurs fois plus lourd — un png en 4k d’une photo ordinaire fait déjà environ 16 Mo. webp se situe entre les deux.
Peut-il sauver un texte minuscule ou un visage flou ?
En partie seulement. Il affine ce que contient la source ; les détails jamais capturés sont inventés, si bien qu’un lettrage illisible peut revenir sous forme de tracés plausibles plutôt que des mots d’origine. Partez de la version la plus propre dont vous disposez.
Quelles sont les limites de l’API Image Upscaler ?
Résolutions: 2K · 4K · 8K. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Image Upscaler sans écrire de code ?
Oui. Le Playground lance Image Upscaler avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.