OpenAI

GPT Image 2.5

gpt-image-2.5-sunburst/text-to-image

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/image-to-image gpt-image-2.5-flare/text-to-image gpt-image-2.5-sunburst/image-to-image gpt-image-2.5-sunburst/text-to-image

Essayer gpt-image-2.5-sunburst/text-to-image

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/text-to-image per image

Spécifications	Prix unitaire
1K	$0.050
2K	$0.080
4K	$0.120

Présentation

gpt-image-2.5-sunburst/text-to-image est la voie texte-vers-image du modèle d'image OpenAI gpt-image-2.5, positionnée sur la priorité à la précision : elle échange un temps de génération unique plus long contre une restitution plus fine des détails. Elle accepte une invite textuelle en entrée, produit une image unique, prend en charge trois paliers de résolution (1K, 2K, 4K) et de multiples ratios d'image ; elle convient aux flux de création et de production exigeant un haut niveau de détail et une grande stabilité de mise en page (visuels de marque, ressources e-commerce, illustrations de contenu) et acceptant une attente plus longue.

Points clés

Variante axée sur la précision — échange un temps de génération unique plus long contre la fidélité des détails, adaptée aux tâches de génération où la qualité visuelle prime.
Résolutions de 1K à 4K au choix — la résolution de sortie est sélectionnable par paliers, avec 13 ratios d'image, une seule requête suffit à s'adapter aux différents formats de diffusion.
Fond transparent spécifiable — en résolution 1K, un fond transparent ou uni peut être spécifié, ce qui réduit les opérations supplémentaires de détourage et de composition en post-traitement.

Capacités

Génération d'images à partir d'invites longues : l'invite peut atteindre 20 000 caractères, ce qui permet de porter une description visuelle et des exigences de mise en page assez complètes, adaptées à l'expression d'intentions visuelles complexes.

Contrôle de la résolution et du ratio : choisissez 1K, 2K ou 4K via resolution, spécifiez un ratio allant de 1:1 à 21:9 via aspect_ratio, ou laissez auto décider automatiquement.

Sortie à fond transparent : le paramètre background prend en charge trois modes — transparent, opaque et auto —, disponible uniquement en résolution 1K ; pour les sorties en haute résolution, ce paramètre doit être omis.

Rendu des détails et cohérence : des améliorations ont été apportées au rendu de l'éclairage et des matériaux, à la cohérence du sujet de référence et au respect d'instructions visuelles complexes ; lors de retouches répétées, la mise en page et le sujet sont plus faciles à préserver.

Cas d'usage

Génération de visuels de marque pour les équipes design et marketing — générez affiches, présentations et illustrations de sites web à partir de descriptions textuelles, choisissez le ratio et la résolution selon l'emplacement de diffusion, puis passez directement à la mise en page.
Production de ressources pour l'e-commerce et les pages produit — saisissez les arguments produit et la description du contexte pour obtenir des ressources visuelles utilisables sur les pages de détail produit et les supports de présentation visuelle.
Génération d'illustrations pour créateurs et contenus sociaux — générez des illustrations en série selon le thème du contenu, avec différents ratios adaptés aux dimensions de chaque plateforme.
Flux de composition nécessitant des ressources transparentes — générez des images à fond transparent en palier 1K et superposez-les directement sur des pages ou des maquettes existantes.

Limites et conseils de choix

Sunburst échange de la vitesse contre de la précision : chaque requête est longue, ce qui le rend inadapté à la génération rapide à faible latence et à forte concurrence ; pour des délais plus courts, préférez la variante Flare, et pour l'édition à partir d'une image de référence, choisissez la voie image-to-image de la même famille. La sortie 4K entraîne des coûts de calcul et de temps plus élevés ; les mises en page comportant beaucoup de textes en petits corps ou des légendes complexes restent des scénarios difficiles et nécessitent une relecture humaine. Le modèle est un service hébergé, sans prise en charge du déploiement local ni du réglage fin personnalisé.

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/text-to-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

promptstringRequisminLength 1maxLength 20000

Prompt de génération d'image, utilisé pour décrire la scène que l'on souhaite générer ; type chaîne de caractères, longueur maximale de 20000 caractères.

backgroundstringOptionnel

Mode d'arrière-plan, contrôle la façon dont l'arrière-plan de l'image générée est traité ; type chaîne de caractères. Ce paramètre n'est pris en charge qu'en résolution 1K ; en résolution 2K/4K, veuillez l'omettre.

Options：transparentopaqueauto

resolutionstringOptionnelDéfaut: "1K"

Niveau de résolution de sortie, contrôle le niveau de résolution de l'image générée ; type chaîne de caractères, 1K par défaut. Lorsque background vaut auto, opaque ou transparent, seule la résolution 1K est prise en charge.

Options：1K2K4K

aspect_ratiostringOptionnelDéfaut: "auto"

Rapport largeur-hauteur de sortie, contrôle le format de l'image générée ; type chaîne de caractères, auto par défaut ; s'il est omis, il est traité comme auto.

Options：auto1:13:22:34:33:416:99:16

Tout afficher (5)

21:927:1616:279:88:9

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/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "auto"
  }
}'

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/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "auto"
    }
  }),
});
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/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "auto"
        }
    },
)
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"
    }
  }
}