OpenAI

GPT Image 2.5

gpt-image-2.5-sunburst

Modèles d'OpenAI de génération et d'édition d'images à deux niveaux, Flare privilégiant la vitesse et Sunburst la précision, couvrant à la fois la génération d'images à partir de texte et la retouche d'images en plusieurs tours

Route

default pro

gpt-image-2.5-flare gpt-image-2.5-sunburst

Essayer gpt-image-2.5-sunburst

Entrée

Créations

Voir toutes les créations

Sortie

image

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

gpt-image-2.5-sunburst per image

Spécifications	Prix unitaire
low	$0.0172
medium	$0.0672
high	$0.1829
xhigh	$0.3572
max	$0.7143
auto	$0.3572

Présentation du positionnement

gpt-image-2.5-sunburst est une variante de la famille d'images OpenAI gpt-image-2.5 axée sur la précision. Elle prend en charge à la fois la génération texte-image et l'édition d'images, et est accessible via l'interface unifiée de HiAPI.ai. Elle apporte des améliorations dans le rendu de l'éclairage et des matériaux, la cohérence du sujet de référence ainsi que le respect d'instructions visuelles complexes, et prend en charge des sorties jusqu'à 3840 px avec fond transparent. Elle convient aux créations design exigeant une grande fidélité aux détails, à la production de visuels de marque et aux workflows d'images nécessitant des retouches répétées.

Points clés

Restitution des détails priorisant la précision — un temps de génération unique plus long en échange de détails et de textures plus fins, adapté aux tâches exigeant une grande qualité d'image finale.
Cohérence du sujet maintenue lors des éditions successives — lors de modifications répétées à partir d'une image de référence, le sujet de référence et la mise en page restent plus facilement cohérents, ce qui réduit les reprises à chaque itération.
Haute résolution et fond transparent — les paliers de taille vont jusqu'à 3840 px et permettent une sortie avec fond transparent, ce qui réduit les coûts de détourage et de composition en post-production.

Description des capacités

Génération texte-image et édition d'images sur la même variante : la même variante permet soit de générer directement une image à partir d'un prompt, soit de transmettre une image de référence pour effectuer une édition, une composition ou conserver le style et le sujet, sans changer de modèle.

Entrée multi-références : il est possible de transmettre jusqu'à 16 images de référence en une seule fois, pour une composition multi-éléments ou pour conserver le sujet et le style d'une image à l'autre, ce qui convient aux scènes nécessitant l'assemblage de plusieurs éléments visuels.

Formats et tailles en pixels au choix : prise en charge de ratios comme 1:1 ou 16:9 jusqu'à des tailles en pixels de niveau 2048 ou 3840, ou décision automatique confiée au modèle, pour un alignement facilité avec les pages de destination et les emplacements de visuels.

Contrôle de la qualité et du format de sortie : la qualité est réglable sur plusieurs niveaux, de low à max, ce qui influence le niveau de détail, la vitesse et le palier de facturation ; la sortie prend en charge png, jpeg et webp, avec un fond automatique ou transparent au choix.

Mises en page complexes et prompts longs : la limite de prompt est de 20000 caractères, ce qui permet de porter des instructions visuelles et des descriptions de mise en page assez longues, adaptées aux visuels et infographies à structure complexe.

Cas d'usage

Équipes de design de marque et marketing : créations précises — saisir les besoins de design et des images de référence pour produire des visuels de marque haute résolution, destinés au site web, aux présentations et aux supports publicitaires.
Workflow de design : retouches répétées à partir d'une image existante — transmettre l'image d'origine et les consignes de modification, itérer tour après tour en conservant la cohérence du sujet et de la mise en page, et produire une version finale livrable pour la revue de design.
E-commerce et pages produit : composition multi-éléments — composer une image principale à partir de plusieurs photos produit et de références de scène, pour produire des visuels produit directement utilisables en boutique.
Production d'éléments : éléments à fond transparent — générer selon un prompt des éléments graphiques à fond transparent, directement superposables sur une page ou une affiche.

Limites et conseils de choix

sunburst vise la précision et chaque requête est donc plus longue ; elle ne convient pas aux scènes à faible latence ou à forte concurrence avec génération par lots ; les sorties haute résolution augmentent encore le temps de calcul et d'attente. Les images contenant beaucoup de textes en petits caractères ou des légendes complexes restent des scènes difficiles, et une relecture humaine est recommandée. Si vous recherchez un équilibre entre vitesse et qualité ou une génération par grands lots, la variante flare de la même famille peut être envisagée. L'utilisation de tous les contenus générés est soumise aux politiques d'utilisation d'OpenAI ; le modèle est en source fermée et ne prend pas en charge le déploiement local ni le réglage fin par vos soins.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le 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-KeystringOptionnel

Clé 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.

Clé d'idempotence

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

modelstringRequis

Valeur fixe actuelle : gpt-image-2.5-sunburst

routestringOptionnel

Valeur fixe actuelle : pro

inputobjectRequis

Objet de paramètres métier pour gpt-image-2.5-sunburst et la route pro — voir le tableau des paramètres ci-dessous.

promptstringRequisminLength 1maxLength 20000

Invite de description de l'image à générer, ou d'explication des modifications à appliquer à l'image de référence ; type chaîne, 20000 caractères maximum.

qualitystringOptionnelDéfaut: "medium"

Niveau de qualité d'image, qui détermine le niveau de détail en sortie, la vitesse de génération et le prix ; type chaîne, valeur par défaut medium.

Options：lowmediumhighxhighmaxauto

backgroundstringOptionnelDéfaut: "auto"

Mode d'arrière-plan, permettant de choisir un fond automatique, transparent ou opaque ; type chaîne, valeur par défaut auto.

Options：autotransparentopaque

image_urlsarrayOptionnelminItems 1maxItems 16

Tableau d'images de référence, dont les éléments sont des adresses d'images ; une fois fournies, elles servent à l'édition, à la composition ou à conserver le sujet et le style ; si aucune n'est fournie, il s'agit d'une génération purement textuelle.

Array [ string ]

aspect_ratiostringOptionnelDéfaut: "1:1"

Format de sortie ou dimensions en pixels ; type chaîne, valeur par défaut 1:1 ; réglé sur auto, le modèle le détermine selon la requête.

Options：1:13:22:34:33:416:99:16auto

Tout afficher (10)

1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840

output_formatstringOptionnelDéfaut: "webp"

Format de l'image de sortie ; type chaîne, valeur par défaut webp.

Options：pngjpegwebp

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

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.

urlstringRequis

Obligatoire 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.

Options：final

storagestringOptionnelDé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.

Options：temppersistent

Exemples 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.5-sunburst@pro",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "background": "auto",
    "aspect_ratio": "1:1",
    "output_format": "webp"
  }
}'

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.5-sunburst@pro",
    input: {
      "prompt": "…",
      "quality": "medium",
      "background": "auto",
      "aspect_ratio": "1:1",
      "output_format": "webp"
    }
  }),
});
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.5-sunburst@pro",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "background": "auto",
          "aspect_ratio": "1:1",
          "output_format": "webp"
        }
    },
)
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

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom 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.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

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.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes 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

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description 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"
    }
  }
}