OpenAI

GPT Image 2.5

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

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

Présentation

La voie d'édition d'images de gpt-image-2.5-sunburst s'adresse aux développeurs qui doivent apporter des modifications et des extensions à haute fidélité sur des images existantes. Elle accepte de une à seize images de référence accompagnées d'une instruction d'édition, produit des images aux paliers de résolution 1K, 2K et 4K, et prend en charge la spécification du format d'image ainsi que du fond transparent ; elle convient donc aux workflows de retouche de design exigeant une cohérence du sujet sur plusieurs itérations. Sunburst échange un temps de traitement plus long contre une précision de restitution des détails accrue.

Points clés

Une voie d'édition axée sur la précision — la variante Sunburst échange un temps de traitement unitaire plus long contre une restitution plus fine des détails, ce qui la destine aux tâches d'édition sensibles à la qualité finale.
Jusqu'à seize images de référence en entrée conjointe — une requête peut soumettre de une à seize images sources ou de référence, afin de confier au modèle les informations de sujet, de style et de mise en page en une seule fois.
Quatre paliers de format et de résolution au choix — la sortie prend en charge trois paliers de résolution (1K, 2K, 4K) et treize formats d'image, directement alignés sur les spécifications de livraison, ce qui réduit les recadrages ultérieurs.
Fond transparent possible en 1K — le mode fond transparent est réservé à la résolution 1K ; les éléments transparents générés peuvent entrer directement dans le pipeline de composition ultérieur.

Capacités

Édition conditionnée par plusieurs images de référence : soumettre via image_urls de une à seize images JPEG, PNG ou WebP, accompagnées d'une instruction d'édition pouvant atteindre vingt mille caractères, pour réécrire, remplacer ou étendre des éléments existants.

Contrôle de la résolution et du format : resolution sélectionne le palier de sortie 1K, 2K ou 4K ; aspect_ratio prend en charge treize ratios, de 1:1 à 21:9 ; la valeur par défaut auto laisse le modèle décider.

Génération avec fond transparent : background peut valoir transparent, opaque ou auto ; le mode transparent n'est disponible qu'en résolution 1K, ce qui permet de produire directement des éléments sans détourage.

Restitution fine des détails : la variante Sunburst privilégie la fidélité des détails et se rapproche davantage des images de référence en matière de texture, d'éclairage et de structure de mise en page ; elle convient aux passes d'édition à forte exigence de qualité finale.

Cas d'usage

Refonte en série de supports de marque existants par une équipe design — soumettre la charte visuelle de la marque comme image de référence, remplacer textes et couleurs selon une instruction unifiée, et produire une série de supports pour une campagne.
Retouche de photos produit et de scènes par les équipes e-commerce — partir de photos réelles du produit, générer des visuels avec un nouveau fond ou une nouvelle scène, directement utilisables sur les pages produit et dans les supports publicitaires.
Itérations successives sur une même image par les créatifs — réinjecter continuellement le résultat courant comme entrée avec des instructions complémentaires, converger progressivement vers la version finale et livrer un visuel prêt à l'emploi.
Besoin de formes à fond transparent en production d'éléments — générer en 1K une image à fond transparent à partir d'une image de référence et d'une instruction d'édition, puis l'utiliser comme calque dans la composition et la mise en page ultérieures.

Limites et conseils de choix

Sunburst privilégie la précision : une requête est plus longue, ce qui la rend inadaptée aux scénarios à faible latence ou à très forte concurrence ; les sorties 2K et 4K augmentent encore le coût de calcul et le temps d'attente ; le fond transparent est limité à 1K. Les mises en page comportant beaucoup de petits textes ou des légendes complexes restent sujettes à erreurs : une relecture humaine après génération est recommandée. Ce modèle propriétaire ne permet ni déploiement local, ni fine-tuning autonome, ni inférence hors ligne ; il faut alors opter pour une autre solution. Pour une génération rapide en série, la voie Flare de la même famille peut être envisagée.

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

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

promptstringRequisminLength 1maxLength 20000

Instruction de génération ou d'édition décrivant le contenu à générer ou à modifier à partir de l'image source, sous forme de chaîne, jusqu'à 20000 caractères.

backgroundstringOptionnel

Mode d'arrière-plan, sous forme de chaîne ; pris en charge uniquement en résolution 1K, à omettre en 2K/4K.

Options：transparentopaqueauto

image_urlsarrayRequisminItems 1maxItems 16

Tableau d'images sources ou de référence, éléments au format JPEG, PNG ou WebP, de 1 à 16 images.

Array [ string ]

resolutionstringOptionnelDéfaut: "1K"

Niveau de résolution de sortie, sous forme de chaîne, 1K par défaut ; lorsque background vaut auto/opaque/transparent, seule la résolution 1K est prise en charge.

Options：1K2K4K

aspect_ratiostringOptionnelDéfaut: "auto"

Rapport d'aspect de sortie, sous forme de chaîne, auto par défaut ; en cas d'omission, il est également 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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "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"
    }
  }
}