OpenAI

GPT Image 2.5

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

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

Présentation du positionnement

gpt-image-2.5-flare est la voie de génération d'images à partir de texte de la famille de génération d'images OpenAI ; elle réalise un équilibre entre vitesse et qualité et convient aux applications nécessitant une génération d'images en lot. Elle accepte des prompts d'une longueur maximale de 20000 caractères, permet de spécifier une résolution de 1K à 4K ainsi que divers rapports d'aspect, et prend en charge la sortie sur fond transparent en 1K. Par rapport à la génération précédente, cette version réduit la latence par image tout en conservant une qualité de génération supérieure, ce qui la rend adaptée aux scénarios exigeant un bon débit, comme les visuels pour le e-commerce, les contenus pour les réseaux sociaux et la validation rapide de prototypes.

Points forts essentiels

Voie de génération d'images à partir de texte alliant vitesse et qualité — Flare se positionne comme le choix par défaut de la plupart des applications : sa qualité est supérieure à celle de la génération précédente tout en raccourcissant nettement la durée d'une génération, ce qui la rend adaptée à la génération d'images à forte concurrence.
Fond transparent directement en 1K — En résolution 1K avec le paramètre background défini sur transparent, on obtient directement une image sur fond transparent, ce qui réduit les étapes de détourage et de composition en post-production.
Résolutions et formats flexibles — Prise en charge de trois paliers de résolution (1K, 2K, 4K) et de plus de dix rapports d'aspect, permettant de choisir directement le format de l'image selon le canal de diffusion.

Description des capacités

Génération d'images à partir de texte avec prompts longs : un prompt unique peut atteindre 20000 caractères, ce qui facilite la description de mises en page complexes et d'informations structurées ; l'image est produite directement à partir du texte, sans besoin de préparer une image de référence.

Contrôle de la résolution et du rapport d'aspect : il est possible de choisir le palier de sortie parmi 1K, 2K et 4K, et de spécifier le format parmi des ratios tels que 1:1, 16:9, 21:9, 9:16, afin de générer en une fois les spécifications adaptées au point de diffusion.

Sortie sur fond transparent : en résolution 1K, on peut définir background sur transparent pour générer une image sur fond transparent, adaptée à la superposition d'éléments et aux flux de composition ultérieurs.

Scénarios d'application

Génération en lot de visuels produits par les équipes e-commerce et marketing — À partir de textes présentant les arguments de vente du produit, générer en lot des visuels au format du canal, directement utilisables pour les pages de détail produit et les supports de diffusion.
Production rapide d'images de contenu par les créateurs de réseaux sociaux — Générer des visuels à l'aide de prompts courts et de ratios 9:16 ou 1:1, réduisant le cycle entre le choix du sujet et la publication.
Validation de prototypes visuels par les équipes produit — Avant la revue des besoins, comparer rapidement plusieurs directions visuelles grâce à la génération d'images à partir de texte, à faible coût et faible latence, puis passer à la finition une fois la solution arrêtée.
Génération d'éléments sur fond transparent par les designers — Produire en mode fond transparent 1K des éléments graphiques directement superposables, destinés aux affiches, aux pages et à la composition vidéo.

Limites et conseils de sélection

Cette voie ne prend en charge que la génération d'images à partir de texte ; elle ne permet ni l'édition à partir d'une image de référence ni les retouches itératives. Pour ce type de besoins, il convient de choisir la voie d'édition d'images de la même famille. Le fond transparent n'est disponible qu'en 1K ; en choisissant 2K ou 4K, il n'est pas possible de spécifier le mode de fond. La sortie en 4K entraîne des coûts de calcul et des durées plus élevés ; pour les scénarios en lot à faible latence, il est conseillé de privilégier le 1K ou le 2K. Les mises en page contenant du texte dense en petite taille ou des légendes complexes restent des cas sujets à erreurs et nécessitent une vérification humaine avant diffusion ; le modèle étant une interface propriétaire, il ne prend pas en charge le déploiement local ni le fine-tuning, et l'utilisation du contenu doit respecter les exigences de conformité applicables.

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

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour gpt-image-2.5-flare/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 à générer, de type chaîne de caractères, jusqu'à 20 000 caractères.

backgroundstringOptionnel

Mode d'arrière-plan, valeur de type chaîne de caractères. Pris en charge uniquement en résolution 1K ; lors de l'utilisation des résolutions 2K/4K, veuillez omettre ce paramètre.

Options：transparentopaqueauto

resolutionstringOptionnelDéfaut: "1K"

Niveau de résolution de sortie, valeur de 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, valeur de 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-flare/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-flare/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-flare/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"
    }
  }
}