OpenAI

GPT Image 2.5

gpt-image-2.5-flare

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-flare

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

gpt-image-2.5-flare est la version de la série d'images OpenAI gpt-image-2.5 qui privilégie l'équilibre entre vitesse et qualité. Elle s'appelle via une interface unifiée sur HiAPI.ai et prend en charge à la fois la génération d'images à partir de texte et l'édition d'images à partir d'images de référence. Elle convient à la production visuelle commerciale nécessitant une génération d'images stable, à la génération de contenu en masse et aux flux de retouche d'images, avec une résolution allant jusqu'à 3840 px, un fond transparent et divers formats et ratios d'image.

Points clés

La vitesse avant tout, sans compromis sur la qualité — par rapport à la génération précédente GPT-Image-2, la qualité est améliorée tout en réduisant nettement la latence, ce qui convient aux tâches par lots exigeant un certain rythme de génération.
Génération et édition sur le même canal — le même modèle peut générer à partir de zéro selon un prompt, ou recevoir des images de référence pour l'édition, la composition et la conservation du style du sujet.
Large couverture des ratios et résolutions — prend en charge des ratios allant de 1:1 à 16:9, 9:16, etc., ainsi qu'une sortie directe jusqu'à 3840x2160 pixels.
Fond transparent et formats contrôlables — choix d'un fond transparent et des formats de sortie png, jpeg, webp, ce qui réduit le post-traitement des ressources après production.

Description des capacités

Génération d'images à partir de texte : génère une image à partir d'un prompt descriptif, prend en charge des prompts structurés longs et des exigences de mise en page complexes, idéal pour produire directement des images utilisables à partir de texte.

Édition et conservation à partir d'images de référence : jusqu'à 16 images de référence peuvent être fournies pour l'édition, la composition ou la conservation du sujet et du style lors des modifications, ce qui réduit les réglages répétés.

Choix du niveau de qualité : propose des niveaux de qualité de low à max ainsi que auto ; les développeurs peuvent arbitrer selon les scénarios entre vitesse de génération et rendu des détails.

Contrôle de la résolution et du ratio : permet de spécifier un ratio ou une taille en pixels précise, avec des paliers comme 1024, 1536, 2048, 3840 ; auto laisse le modèle décider.

Format de sortie et fond : prend en charge trois formats png, jpeg, webp et des réglages de fond automatique, transparent ou opaque, pour produire directement des fichiers de ressources utilisables.

Scénarios d'application

Illustrations commerciales pour les équipes de marque et de marketing — saisir une description visuelle de marque ou une image de référence pour produire des visuels de présentations, de pages d'atterrissage et de publicités, livrés en lot à la bibliothèque de ressources via l'interface unifiée.
Génération d'images pour les réseaux sociaux des créateurs de contenu — soumettre des prompts en lot selon un script ou un thème pour obtenir des images de multiples ratios, destinées à la publication sur les réseaux sociaux et à la planification de contenu.
Création de ressources pour l'e-commerce et les pages produits — à partir d'images de référence de produits et d'instructions de modification, générer des visuels de mise en scène destinés directement aux pages de détail des produits et aux ressources de recherche visuelle.
Retouches itératives dans le flux de conception — éditer plusieurs fois à partir d'images existantes tout en conservant la cohérence du sujet et de la mise en page, pour la validation de prototypes et l'itération des maquettes.

Limites et conseils de sélection

Modèle propriétaire, il ne peut être déployé localement ni affiné soi-même ; sa sortie dépend de l'appel à l'interface. La génération en haute résolution entraîne des coûts de calcul et de temps plus élevés ; les textes denses en petite taille et les légendes complexes restent des cas d'erreur fréquents et nécessitent une relecture humaine. Si la tâche exige une fidélité extrême aux détails et tolère une attente plus longue, gpt-image-2.5-sunburst est plus adapté ; pour une génération par lots quotidienne à faible latence, ce canal est le choix par défaut. La conformité du contenu doit respecter les politiques d'utilisation 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

routestringOptionnel

Valeur fixe actuelle : pro

inputobjectRequis

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

promptstringRequisminLength 1maxLength 20000

Décrit le contenu de l'image à générer, ou précise les modifications à appliquer à l'image de référence ; chaîne de caractères, maximum 20 000 caractères.

qualitystringOptionnelDéfaut: "medium"

Contrôle le niveau de détail des images générées, la vitesse de génération et le palier tarifaire ; chaîne de caractères, valeur par défaut medium.

Options：lowmediumhighxhighmaxauto

backgroundstringOptionnelDéfaut: "auto"

Contrôle le mode d'arrière-plan des images générées (auto, transparent ou opaque) ; chaîne de caractères, valeur par défaut auto.

Options：autotransparentopaque

image_urlsarrayOptionnelminItems 1maxItems 16

Tableau facultatif d'images de référence ; une fois fournies, elles servent à éditer ou composer l'image, ou à conserver le sujet et le style ; chaque élément est l'adresse d'une image.

Array [ string ]

aspect_ratiostringOptionnelDéfaut: "1:1"

Contrôle le rapport d'image ou la taille en pixels des images générées ; chaîne de caractères, valeur par défaut 1:1 ; si défini sur auto, le modèle le détermine lui-même selon la requête.

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

Tout afficher (10)

1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840

output_formatstringOptionnelDéfaut: "webp"

Contrôle le format de fichier des images générées ; chaîne de caractères, 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-flare@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-flare@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-flare@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"
    }
  }
}