OpenAI
GPT Image 2.5
gpt-image-2.5-flare/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
Essayer gpt-image-2.5-flare/image-to-image
Entrée
Créations
Voir toutes les créationsSortie
imageTarifs
gpt-image-2.5-flare/image-to-image per image
| Spécifications | Prix unitaire |
|---|---|
| 1K | $0.050 |
| 2K | $0.080 |
| 4K | $0.120 |
Présentation
gpt-image-2.5-flare/image-to-image est l'interface dédiée à l'édition d'images de la famille de modèles d'image OpenAI : elle prend en entrée une à seize images de référence et une instruction d'édition, et produit une image unique. Par rapport à Sunburst, Flare privilégie l'équilibre entre vitesse et qualité d'image, ce qui convient aux applications nécessitant une génération rapide ou un traitement par lots. Les développeurs peuvent l'appeler via l'interface unifiée de HiAPI.ai, en choisissant entre des résolutions de 1K à 4K et divers formats d'image, avec également la prise en charge de la sortie sur fond transparent, ce qui convient aux tâches de transformation d'images telles que les visuels e-commerce, l'identité de marque et la retouche de design.
Points clés
- Entrée de plusieurs images de référence, jusqu'à 16 — une requête peut transporter jusqu'à 16 images sources ou de référence, ce qui facilite la fusion de plusieurs éléments ou le verrouillage du sujet et de la mise en page.
- Fond transparent limité au palier 1K — le mode de fond propose trois options : transparent, opaque et automatique, mais n'est disponible qu'en résolution 1K ; pour 2K et 4K, ce paramètre doit être omis.
- Résolution et format au choix — la sortie prend en charge trois paliers (1K, 2K, 4K) et treize formats d'image, avec un format automatique par défaut, et peut être prédéfinie selon l'emplacement de diffusion.
- Flare privilégie l'équilibre vitesse/qualité — une autre version de la même famille, Sunburst, est orientée précision ; Flare convient mieux aux flux d'édition courants soumis à des contraintes de temps de réponse.
Description des capacités
Édition avec références multiples : accepte jusqu'à 16 images JPEG, PNG ou WebP, accompagnées d'une instruction descriptive pouvant atteindre vingt mille caractères, pour redessiner une scène tout en conservant le sujet et la mise en page de référence.
Contrôle de la résolution et du format : permet de spécifier un palier de sortie 1K, 2K ou 4K et de choisir parmi des ratios tels que 1:1, 16:9, 9:16, 21:9, ce qui réduit les coûts de recadrage post-traitement et aligne directement la production sur les dimensions de diffusion.
Basculement du mode de fond : en résolution 1K, le fond peut être défini comme transparent, opaque ou automatique ; la sortie transparente facilite l'intégration directe dans les flux de composition et de mise en page, en réduisant l'étape de détourage.
Révision fine par instructions : grâce à un quota de prompt plus long et à une bonne adhésion aux instructions visuelles complexes, il est possible d'effectuer des remplacements locaux, des ajustements de style et des retouches de détails sur une image existante, ce qui convient aux flux d'édition itératifs.
Cas d'usage
- Opérations e-commerce : transformation par lots de visuels produits — saisir des photos réelles de produits et des instructions de retouche pour produire des visuels produits en plusieurs dimensions et formats, destinés aux pages de détail, aux images principales et aux emplacements publicitaires.
- Marketing de marque : composition de visuels à partir de plusieurs références — fusionner plusieurs images de référence pour générer des ébauches visuelles au style cohérent, utilisées pour la validation préalable de propositions, de présentations et d'illustrations de site web.
- Collaboration design : retouches itératives sur une mise en page existante — partir d'une maquette existante pour modifier progressivement le sujet, l'éclairage et le fond, et produire des images directement intégrables dans la mise en page finale.
- Production d'éléments : sortie d'images sur fond transparent — générer au palier 1K des éléments sur fond transparent, destinés aux icônes, aux textures et aux bibliothèques d'éléments composites, en évitant l'étape de détourage supplémentaire.
Limites et conseils de sélection
Cette interface ne réalise que de l'édition d'images : elle exige au moins une image source et ne permet pas la génération purement textuelle ; le mode de fond ne s'applique qu'au palier 1K et doit être omis en 2K et 4K. Les mises en page comportant de nombreux textes en petits caractères ou des légendes complexes restent sujettes à erreurs et nécessitent une vérification humaine. Pour une fidélité de détail plus élevée avec un temps d'attente plus long acceptable, on peut choisir la ligne Sunburst ; pour une génération purement textuelle, il faut utiliser la ligne text-to-image correspondante. Les sorties en haute résolution augmentent la charge de calcul et le temps d'attente.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe 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-KeystringOptionnelClé 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.
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
modelstringRequisValeur fixe actuelle : gpt-image-2.5-flare/image-to-image
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour gpt-image-2.5-flare/image-to-image et la route default — voir le tableau des paramètres ci-dessous.
promptstringRequisminLength 1maxLength 20000Instruction de génération ou d'édition décrivant le contenu à générer ou à éditer à partir de l'image source, 20000 caractères maximum.
backgroundstringOptionnelMode d'arrière-plan, pris en charge uniquement en résolution 1K ; omettez ce paramètre lors de l'utilisation des résolutions 2K/4K.
transparentopaqueautoimage_urlsarrayRequisminItems 1maxItems 16Tableau d'images sources ou de référence, de 1 à 16 images, aux formats JPEG, PNG ou WebP.
Array [ string ]
resolutionstringOptionnelDéfaut: "1K"Niveau de résolution de sortie, 1K par défaut ; lorsque background vaut auto, opaque ou transparent, seule la résolution 1K est prise en charge.
1K2K4Kaspect_ratiostringOptionnelDéfaut: "auto"Rapport d'aspect de sortie, auto par défaut s'il est omis.
auto1:13:22:34:33:416:99:16Tout afficher (5)
21:927:1616:279:88:9callbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
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.
urlstringRequisObligatoire 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.
finalstoragestringOptionnelDé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.
temppersistentExemples 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/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-flare/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-flare/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
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom 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.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
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.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes 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
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription 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"
}
}
} Articles
Voir tous les articles →-
Tutoriel
recraft-v4.1-flash génération d'images texte-à-image en pratique : 5 scénarios métier à forte valeur et points d'intégration clés
À partir d'un coût de 0,01 $ par image, planifier le déploiement de la génération d'images dans de vrais contextes métier
-
Tutoriel
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
Tutoriel
Comment appeler hailuo-2.3-fast/image-to-video via l'API HiAPI : curl et Python en pratique
La première requête exploitable du palier image-vers-vidéo rapide et économique — de l'ID du modèle au téléchargement du MP4
-
Tutoriel
Comment utiliser kling-4.0/text-to-video via l'API HiAPI : curl, Python et un exemple de requête fonctionnel
Guide pratique pour les développeurs : prompts cinématographiques, audio synchronisé, interrogation asynchrone et téléchargement des sorties
-
Comparatif et évaluation
Comparatif horizontal de Recraft v4.1 Flash en génération d'images à partir de texte : guide de sélection et de migration pour les développeurs
Avec un coût de 0,01 $ par image et ses capacités de génération pure à partir de texte, déterminez s'il convient à votre pipeline de génération d'images
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
-
Tutoriel
Utiliser Kandinsky 6.0 Pro texte-vers-vidéo sur HiAPI : tutoriel curl et Python
Démonstration pratique axée sur la requête : construire l'appel du prompt au clip vidéo, soumettre la requête, interroger l'état d'achèvement et télécharger le résultat
-
Tutoriel
Tutoriel pour kandinsky-6.0-pro/image-to-video sur HiAPI : curl + Python
Lancer une requête image-vers-vidéo exploitable sur HiAPI : de l'envoi de la première image à l'interrogation asynchrone jusqu'au téléchargement final
-
Comparatif et évaluation
Comparatif transversal de hailuo-2.3-fast/image-to-video : comment choisir un modèle image-to-video et les points clés de migration
Modèles associés
Voir tous les modèles →Même type
-
FLUX 1.1 Pro Black Forest Labs $0.050 /image -
FLUX.1 Schnell Black Forest Labs $0.005 /image -
Google Virtual Try-On Google $0.107 /image -
Nano Banana Google $0.021 /image -
Wan 2.7 Image Alibaba $0.035 /image -
Nano Banana 2 Google $0.036 /image -
Nano Banana Pro Google $0.057 /image -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /image -
GPT Image 2.5 OpenAI $0.017 /image -
FLUX.2 Black Forest Labs $0.035 /image -
Grok Imagine xAI $0.011 /seconde -
Ideogram V4.5 Ideogram $0.011 /image







