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 · 1:2 · 1:3 · 2:1 · 2:3 · 3:1 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 9:21 · 16:9 · 21:9 · Par défaut: 1:1 |
background | Non | Garder, supprimer ou remplacer l’arrière-plan. auto · transparent · opaque · Par défaut: auto |
image_urls | Oui | Les photos à retoucher ou combiner. Dites dans le prompt ce que chacune apporte. |
input_fidelity | Non | How closely to keep the look of the source images. low · high · Par défaut: low |
mask_url | Non | Peignez la zone qui doit changer. |
num_outputs | Non | Combien de résultats en une fois. ≥ 1 · ≤ 10 · Par défaut: 1 |
output_format | Non | Le type de fichier du résultat. png · jpeg · webp · Par défaut: png |
output_quality | Non | Compression quality for JPEG and WebP, from 0 to 100. ≥ 0 · ≤ 100 |
prompt | Oui | Say what to change and what must stay the same. |
quality | Non | Plus de temps et de prix pour des détails plus fins. low · medium · high · xhigh · max · Par défaut: high |
resolution | Non | Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 1k · 2k · 4k · Par défaut: 1k |
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 |
|---|---|---|
| aspect_ratio 1:3 · quality low · resolution 1K | 0,27 | 0,0027 $US |
| aspect_ratio 3:1 · quality low · resolution 1K | 0,27 | 0,0027 $US |
| aspect_ratio 21:9 · quality low · resolution 1K | 0,37 | 0,0037 $US |
| aspect_ratio 9:21 · quality low · resolution 1K | 0,37 | 0,0037 $US |
| aspect_ratio 1:2 · quality low · resolution 1K | 0,41 | 0,0041 $US |
| aspect_ratio 2:1 · quality low · resolution 1K | 0,41 | 0,0041 $US |
| aspect_ratio 1:3 · quality low · resolution 2K | 0,43 | 0,0043 $US |
| aspect_ratio 3:1 · quality low · resolution 2K | 0,43 | 0,0043 $US |
| aspect_ratio 16:9 · quality low · resolution 1K | 0,46 | 0,0046 $US |
| aspect_ratio 9:16 · quality low · resolution 1K | 0,46 | 0,0046 $US |
| aspect_ratio 2:3 · quality low · resolution 1K | 0,54 | 0,0054 $US |
| aspect_ratio 3:2 · quality low · resolution 1K | 0,54 | 0,0054 $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 GPT Image 2.5 Sunburst 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 openai/gpt-image-2.5-sunburst/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": "openai/gpt-image-2.5-sunburst/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "high",
"num_outputs": 1,
"input_fidelity": "low"
}
}'
# 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 GPT Image 2.5 Sunburst
Combien coûte l’API GPT Image 2.5 Sunburst ?
GPT Image 2.5 Sunburst coûte à partir de 1 crédit (0,01 $US) par image avec Modifier une image, sa tâche la moins chère. Prix par option : 1:3 · low · 1K 0,27 crédit par image, 3:1 · low · 1K 0,27 crédit par image, 21:9 · low · 1K 0,37 crédit par image, 9:21 · low · 1K 0,37 crédit 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 GPT Image 2.5 Sunburst dans l’API ?
Indiquez openai/gpt-image-2.5-sunburst/text-to-image pour Créer une image; openai/gpt-image-2.5-sunburst/edit pour Modifier une image dans le champ model de POST /jobs/createTask.
La transparence fonctionne-t-elle vraiment ?
Oui. Avec background sur transparent et une sortie PNG ou WebP, nos tests de détourage sont revenus avec un vrai canal alpha. Cette option est disponible sur le point de terminaison de retouche ; celui de génération à partir de texte ne propose pas de réglage du fond.
Quelles sont les limites de l’API GPT Image 2.5 Sunburst ?
Résolutions: 1K · 2K · 4K; Formats d’image: 1:1 · 1:2 · 1:3 · 2:1 · 2:3 · 3:1 +9; Résultats par appel: 1–10; Images de référence: 16; Longueur du prompt (caractères): 5,000. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer GPT Image 2.5 Sunburst sans écrire de code ?
Oui. Le Playground lance GPT Image 2.5 Sunburst avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.
Tous les modèles GPT Image
GPT Image 2.5 Flare offre les mêmes options et le même prix par image, mais il est réglé pour la vitesse et termine en général plus vite. Sunburst est celui des images finales et des retouches précises.
- API GPT Image 2.5 SunburstLe modèle d’OpenAI axé qualité, jusqu’en 4K avec un texte propreÀ partir de 1 crédit par image
- API GPT Image 2.5 FlareLe modèle d’OpenAI axé vitesse, avec retouches par masque et détouragesÀ partir de 1 crédit par image
- API GPT Image 2Texte lisible dans l’image et retouches par masque précisesÀ partir de 1 crédit par image

