OpenAI
GPT Image 2.6
gpt-image-2.6-sunburst/text-to-image
Modèles de génération et d’édition d’images à deux niveaux d’OpenAI : Flare privilégie la vitesse, Sunburst vise la précision ; ils produisent directement des GIF animés et des SVG vectoriels et prennent en charge la retouche locale d’image
Essayer gpt-image-2.6-sunburst/text-to-image
Entrée
Sortie
imageTarifs
gpt-image-2.6-sunburst/text-to-image per image
Présentation
gpt-image-2.6-sunburst est la voie de génération d'images à partir de texte de la famille de modèles de génération d'images d'OpenAI, destinée aux développeurs qui doivent produire des images en série via l'interface unifiée de HiAPI.ai. Il permet de générer directement des images à partir d'invites textuelles, avec des formats de sortie couvrant les bitmaps courants ainsi que le SVG vectoriel et le GIF animé, et il est possible de contrôler les spécifications du résultat via des paramètres tels que la qualité, la résolution et le rapport d'aspect. Parmi eux, Sunburst, lors d'itérations multiples en qualité de rendu medium ou supérieure, maintient mieux la cohérence des détails de l'image, ce qui convient aux flux de travail de contenu visuel nécessitant une production continue et des ajustements répétés.
Points clés
- Cohérence des détails plus stable entre les itérations — en qualité de rendu medium ou high, lors de générations ou d'ajustements multiples, Sunburst maintient mieux la cohérence des détails de l'image.
- Formats de sortie étendus au vectoriel et à l'animation — la génération d'images à partir de texte peut produire directement des fichiers vectoriels SVG et des animations GIF, ce qui réduit les étapes de conversion de format en dehors de l'interface.
- Qualité de génération et de planification réglables séparément — quality contrôle la précision de rendu, complexity contrôle indépendamment le niveau de planification, et peut être augmenté séparément pour les textes denses et les mises en page complexes.
- Rapports d'aspect couvrant les mises en page commerciales courantes — aspect_ratio propose plusieurs ratios, de 1:1 à 21:9, 3:1, etc., permettant d'obtenir directement la taille correspondante selon le canal de diffusion.
Description des capacités
Génération d'images à partir de texte : il suffit de saisir une invite de 32 000 caractères maximum pour générer une image ; la sortie est en png par défaut, ce qui convient à la production d'images en série par script.
Qualité de rendu et contrôle hiérarchisé de la planification : quality propose cinq niveaux de précision de rendu, de low à max ; complexity contrôle indépendamment le niveau de planification, et une mise en page complexe peut être planifiée plus finement sans augmenter globalement le niveau de rendu.
Réglage de la résolution et du rapport d'aspect : la résolution propose trois niveaux, 1K, 2K et 4K, et, associée à plusieurs rapports d'aspect, génère directement des tailles de résultat conformes à la mise en page cible.
Sortie multiformat et compression : png, jpeg, webp, gif et svg sont disponibles ; jpeg et webp prennent en charge un niveau de compression de 0 à 100, ce qui facilite l'arbitrage entre qualité d'image et poids du fichier.
Fond transparent et animation GIF : lorsque background est défini sur transparent, la sortie est limitée à png ou webp ; pour le GIF, il est possible de définir le nombre d'images, la taille des images et l'intervalle entre les images ; la fréquence d'images et le format sont directement déterminés par les paramètres.
Scénarios d'utilisation
- Production rapide de croquis créatifs pour les équipes de design — générer plusieurs versions de croquis à partir d'invites courtes, les filtrer selon le niveau de qualité et le rapport d'aspect, puis passer à l'affinage, pour comparer les propositions en phase de concept.
- Production continue d'actifs visuels de marque en série — générer de manière répétée autour d'un même thème ; en qualité moyenne ou élevée, les détails sont plus stables, et les résultats peuvent être utilisés directement pour le site officiel, les pages produit et autres supports nécessitant une unité de style.
- Supports sociaux et événementiels pour les équipes marketing — générer des images en série aux ratios 1:1, 9:16, 16:9, etc., puis les compresser pour la diffusion sur les réseaux sociaux et les pages d'atterrissage d'événements.
- Génération d'actifs vectoriels et animés pour les développeurs — choisir une sortie svg ou gif pour obtenir directement des graphiques vectoriels ou des animations image par image, destinés aux icônes, illustrations et animations légères.
Limites et conseils de sélection
Cette voie ne prend en charge que la génération d'images à partir de texte ; si vous devez modifier localement une image existante en entrée, il faut utiliser la voie image-to-image. L'avantage de cohérence entre les itérations de Sunburst suppose une qualité de rendu medium ou high ; aux niveaux de qualité inférieurs, il ne faut pas s'attendre à la même stabilité. La sortie GIF ne prend pas en charge le paramètre de rapport d'aspect ; la taille des images doit être spécifiée en pixels et respecter la limite du nombre d'images ; le fond transparent n'est compatible qu'avec png et webp. Pour les scénarios exigeant strictement la vitesse de génération et ne nécessitant pas de détails stables, la voie Flare de la même famille peut être évaluée.
Questions fréquentes
Voir toutes les questions →-
Comment se fait la facturation ? Les requêtes refusées sont-elles facturées ?
La facturation se fait à l'image, le prix unitaire étant déterminé par le niveau de qualité et la résolution, voir la grille tarifaire de cette page ; Flare et Sunburst sont au même prix. Pour l'image à image, chaque image de référence ajoute $0.012. Les GIF sont facturés séparément selon le niveau de qualité, indépendamment de la résolution. Les requêtes dont les paramètres sont invalides ou dont la taille du GIF dépasse la limite sont rejetées dès la soumission, et le montant prélevé est intégralement remboursé, sans frais.
-
Est-il possible de modifier seulement une partie de l'image ?
Oui, en utilisant la voie image-vers-image, avec l'une des deux méthodes suivantes au choix. Premièrement, mask_url : transmettez une image PNG RGBA de mêmes dimensions que la première image source ; les pixels entièrement transparents correspondent à la zone à modifier. Deuxièmement, markup_url : transmettez une image PNG transparente annotée, en indiquant par un cercle ou un autre marquage l'emplacement à modifier ; l'annotation elle-même n'apparaîtra pas dans le résultat. Les deux ne peuvent pas être transmises en même temps. Même avec un masque, le modèle peut encore effectuer une légère retouche sur l'ensemble de l'image.
-
Quelle est la différence entre Flare et Sunburst, et lequel choisir ?
Les deux modèles ont exactement les mêmes paramètres, le même mode d'utilisation et le même prix ; la différence réside dans leur orientation. Selon la présentation d'OpenAI, Flare génère les images plus rapidement, ce qui le rend adapté aux itérations rapides et à la génération d'images en lot : c'est le choix par défaut recommandé. Sunburst accorde davantage d'importance aux détails : lors d'éditions en plusieurs passes avec un niveau de qualité medium ou supérieur, les détails des personnages, des produits ou de la mise en page sont préservés de manière plus cohérente. En général, commencez par Flare ; si une même image doit être modifiée à plusieurs reprises et que la stabilité des détails est nécessaire, passez à Sunburst et réglez quality sur medium ou plus.
-
Peut-on générer directement des GIF animés ou des images vectorielles SVG ?
Oui, il suffit de définir output_format sur gif ou svg sur la ligne text-to-image ; la ligne image-to-image ne prend en charge que png, jpeg et webp. Le GIF est contrôlé par trois paramètres : frame_size définit la taille en pixels de chaque image (512x512 par défaut, la largeur et la hauteur déterminent aussi les proportions du GIF), frame_count définit le nombre d'images (2–16, 9 par défaut), frame_duration_ms définit la durée de chaque image (200 millisecondes par défaut). Lors de la génération d'un GIF, ne pas transmettre aspect_ratio ou transmettre auto.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.
Idempotency-KeystringOptionnelClé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.
En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.
Corps
modelstringRequisValeur fixe actuelle : gpt-image-2.6-sunburst/text-to-image
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour gpt-image-2.6-sunburst/text-to-image et la route default — voir le tableau des paramètres ci-dessous.
promptstringRequisminLength 1maxLength 32000Décrivez l'image à générer, jusqu'à 32000 caractères.
qualitystringOptionnelDéfaut: "high"Niveau de qualité de rendu, valeurs possibles : low, medium, high, xhigh, max ; si non renseigné, high.
lowmediumhighxhighmaxbackgroundstringOptionnelMode d'arrière-plan, valeurs possibles : auto, opaque, transparent ; transparent nécessite une sortie png ou webp.
autoopaquetransparentcomplexitystringOptionnelNiveau de planification, indépendant de la qualité de rendu : low convient aux images simples à sujet unique, high convient aux textes denses et aux mises en page complexes ; si non renseigné, high.
lowmediumhighframe_sizestringOptionnelpattern ^(auto|[0-9]+x[0-9]+)$Uniquement pour GIF : largeur x hauteur en pixels de chaque image, par exemple 512x512 ; la largeur et la hauteur déterminent aussi le ratio du GIF. Les deux valeurs doivent être des multiples de 16 ; les écritures de ratio comme 1:1 ne sont pas acceptées ; si non renseigné ou si auto est passé, 512x512. Toutes les images sont assemblées en une seule image complète ; chaque côté de l'image complète ne doit pas dépasser 3840, le nombre total de pixels ne doit pas dépasser 8 294 400 et le rapport largeur/hauteur ne doit pas dépasser 3:1 ; en cas de dépassement, la requête est rejetée au stade de la soumission et n'est pas facturée. 512x512 prend en charge 2 à 16 images, 768x768 jusqu'à 12 images.
moderationstringOptionnelNiveau de modération du contenu, valeurs possibles : auto ou low ; si non renseigné, low.
autolowresolutionstringOptionnelDéfaut: "1K"Niveau de résolution de sortie, valeurs possibles : 1K, 2K, 4K ; si non renseigné, 1K.
1K2K4Kframe_countintegerOptionnelDéfaut: 9min 2max 16Uniquement pour GIF : nombre d'images, entier de 2 à 16 ; si non renseigné, 9. Avec une taille d'image de 768x768, 12 images maximum.
aspect_ratiostringOptionnelDéfaut: "auto"Ratio largeur/hauteur de sortie ; si non renseigné, auto. Non utilisé pour les GIF : si non renseigné ou si auto est passé, utilisez frame_size pour contrôler la taille et le ratio de chaque image.
auto1:13:22:34:33:45:44:5Tout afficher (8)
16:99:162:11:221:99:213:11:3output_formatstringOptionnelDéfaut: "png"Format de sortie, valeurs possibles : png, jpeg, webp, gif, svg ; si non renseigné, png. gif produit une image animée, svg produit un fichier vectoriel ; ces deux formats ne sont pris en charge que pour la génération d'image à partir de texte. Si output_compression est passé, jpeg ou webp doit être passé en même temps ; si l'un des paramètres frame_size, frame_count ou frame_duration_ms est passé, gif doit être passé.
pngjpegwebpgifsvgframe_duration_msintegerOptionnelDéfaut: 200min 20Uniquement pour GIF : durée d'affichage de chaque image, en millisecondes, minimum 20, arrondie à un multiple de 10 millisecondes ; si non renseigné, 200.
output_compressionintegerOptionnelmin 0max 100Niveau de compression 0–100, utilisé uniquement pour jpeg ou webp ; lorsque ce paramètre est passé, output_format doit également être défini sur jpeg ou webp.
callbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.
urlstringRequisObligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.
whenstringOptionnelDéfaut: "final"Seul final est pris en charge pour l'instant — notifié sur success et fail.
finalstoragestringOptionnelDéfaut: "temp"Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.
temppersistentExemples de requête
# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-sunburst/text-to-image",
"input": {
"prompt": "…",
"quality": "high",
"resolution": "1K",
"frame_count": 9,
"aspect_ratio": "auto",
"output_format": "png",
"frame_duration_ms": 200
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-image-2.6-sunburst/text-to-image",
input: {
"prompt": "…",
"quality": "high",
"resolution": "1K",
"frame_count": 9,
"aspect_ratio": "auto",
"output_format": "png",
"frame_duration_ms": 200
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "gpt-image-2.6-sunburst/text-to-image",
"input": {
"prompt": "…",
"quality": "high",
"resolution": "1K",
"frame_count": 9,
"aspect_ratio": "auto",
"output_format": "png",
"frame_duration_ms": 200
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtenir le détail de la tâche
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
queued En file, pas encore démarrée.
handling En cours de traitement.
archiving Traitement terminé, préparation des artefacts.
success Terminal : terminé, artefacts disponibles (output renvoyé).
fail Terminal : échec (error renvoyé).
Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes Unix de l'état terminal ; 0 tant que non terminal.
outputarrayOptionnel
Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).
Array [ object ]
Éléments du tableau
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription de l'erreur.
Exemples de réponse
Succès
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En cours (non terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Échec
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articles
Voir tous les articles →-
Tutoriel
Tutoriel d'intégration de l'API GPT Image 2.6 : choisir entre Flare et Sunburst, mise en œuvre pratique des sorties GIF et SVG
Du choix de l'ID de modèle à la mise en œuvre des paramètres texte-vers-image et image-vers-image, tout sur les paramètres de frames GIF et la sortie SVG
-
Guide d'utilisation
Guide complet des prompts OmniHuman 1.5 : 5 scénarios à copier-coller pour générer directement
Présentation à l'écran en format paysage, présentateur animal, mouvement du corps entier, présentation en anglais, masque multi-personnes, avec de vraies vidéos générées.
-
Comparatif et évaluation
OmniHuman 1.5 vs HeyGen Avatar IV : comment choisir pour une vidéo parlante pilotée par l'audio ?
Choisissez selon quatre critères : les éléments d'entrée, la durée maximale, le prix et les scènes multi-personnes.
-
Tutoriel
Clé API OpenAI invalide : dépannage des erreurs 401, des variables d'environnement et de la configuration du projet
Distinguez les erreurs 401, 403 et 429 d'OpenAI, vérifiez les variables d'environnement ainsi que les paramètres d'organisation et de projet, puis validez les identifiants avec une requête en lecture seule.
-
Guide d'utilisation
Tarifs de l'API OmniHuman 1.5 : 0,193 $ par seconde, 1,54 $ pour 8 secondes de présentation face caméra
Comment fonctionne la facturation à la seconde, le prix d'une vidéo de 8 secondes, combien de vidéos 10 $ permettent de produire, et la règle du prépaiement de 20 secondes.
-
Guide d'utilisation
Tarification de l'API Recraft Creative Upscale : 0,3575 $ par image
Calculez le budget d'agrandissement à l'image, distinguez les limites d'entrée, les vignettes d'affichage et les résultats complets, et comprenez le redessin des détails.
-
Guide d'utilisation
Catalogue de prompts Mureka 9.5 : 6 cas réels à copier directement
Six scénarios — indie pop anglaise, city-pop chinoise, folk acoustique, musique de film, musique d'ambiance lo-fi et musique néo-chinoise — avec pour chacun un résultat réel, le prompt complet et un lien de génération en un clic.
-
Comparatif et évaluation
Recraft V4.1 vs Ideogram 4.5 : comment choisir entre logotype et affiche ?
Des exemples de logotypes et d'affiches issus de deux jeux de prompts soumis identiques, illustrant les différences d'interrupteur d'extension, de palier de qualité, ainsi que de pixels réels, de ratio et de format.
-
Comparatif et évaluation
Recraft Creative Upscale vs Crisp Upscale : comment choisir l'agrandissement d'image ?
Avec les mêmes images d'origine pour le chalet et le lac, comparez le redessin des détails, le budget et les limites d'entrée ; distinguez clairement le résultat complet de l'aperçu de démonstration.
Modèles associés
Voir tous les modèles →Même type
-
FLUX.1 Schnell Black Forest Labs $0.005 /image -
Nano Banana Google $0.011 /image -
Wan 2.7 Image Alibaba $0.035 /image -
Nano Banana Pro Google $0.029 /image -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /image -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /image -
Recraft V4.1 Recraft $0.010 /image -
Recraft Crisp Upscale Recraft $0.004 /image -
GPT Image 2.5 OpenAI $0.017 /image -
Recraft Creative Upscale Recraft $0.357 /image -
Muse Image 1.0 Meta $0.015 per task -
FLUX 3 Image Black Forest Labs $0.041 /image