Skip to Content
ModèlesGPT ImageTexte vers image

Texte vers image

Générez une image à partir d’une consigne textuelle.

Vous n’écrivez pas de code ? Consultez Générer des images dans vos propres outils.

POST/v1/images/generationsParamètres communs Essayer

Avant de commencer

PrérequisDétails
Clé d’APICréez-en une dans la console OfoxAI  et remplacez YOUR_OFOX_API_KEY dans le code
EnvironnementcURL nécessite jq pour décoder l’image ; Python nécessite pip install openai ; Node.js 18 ou version ultérieure, sans dépendance
Délai d’attenteRéglez le délai d’attente du client sur 600 secondes. La haute qualité, les grandes tailles ou l’édition peuvent prendre plusieurs minutes
Valeurs utilisées dans le code
URL de l'APIhttps://api.ofox.ai/v1
Identifiant de modèleopenai/gpt-image-2.5-flare
Clé d'APIRemplacez YOUR_OFOX_API_KEY dans le code par votre clé
Dépendances Pythonpip install openai

Code

Chacun des exemples ci-dessous a été exécuté tel quel. Le résultat est enregistré sous output.png dans le répertoire courant.

Terminal
curl -s https://api.ofox.ai/v1/images/generations \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-image-2.5-flare", "prompt": "A red apple on a white table, soft natural light", "size": "1024x1024", "quality": "low" }' \ -o response.json # The image comes back as base64 — decode and save it (needs jq; on error, read response.json) jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Ajustements courants

Modifiez un paramètre de la requête ci-dessus :

Pour obtenirModifiezRemarques
Une autre taillesizeLes tailles personnalisées doivent respecter les quatre règles
Une meilleure qualitéqualityLes niveaux supérieurs coûtent plus cher et prennent plus de temps — voir Qualité
Des fichiers plus légersoutput_format, output_compressionPassez à jpeg ou webp, puis réglez la compression
Plusieurs imagesn1–10, chacune facturée séparément

Taille (size) et qualité (quality)

  • Taille size : largeur et hauteur multiples de 16, côté le plus long ≤ 3840, rapport d’aspect entre 1:3 et 3:1, nombre total de pixels ≥ 655 360. 768x768 échoue ; 1024x768 fonctionne. Si elle est omise, le modèle décide ; lors de nos tests, il s’agissait de 1254×1254. Voir Taille.
  • Qualité quality : vérifiez d’abord que tout fonctionne avec low, puis montez en gamme. L’omettre n’équivaut pas à medium ; le modèle choisit lui-même un niveau. gpt-image-2 ne propose ni xhigh ni max. La consommation par niveau figure dans Qualité.

Valeurs des paramètres

Valeurs acceptées et valeurs par défaut mesurées pour cette famille. Pour size et quality, voir Taille et Qualité sur la page de vue d’ensemble.

Obligatoires
modelobligatoirestring· valeursopenai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2

Sensible à la casse ; une casse incorrecte renvoie 404. Indiquez l’identifiant complet avec le préfixe openai/.

Courants
ninteger· par défaut 1· valeurs1–10

Chaque image est facturée séparément. Une valeur supérieure à 10 renvoie 400.

output_formatstring· par défaut png· valeurspngjpegwebp

Le bon fonctionnement des trois a été vérifié.

▶Avancés · 4output_compression · background · moderation · partial_imagesExpand
output_compressioninteger· valeurs0–100

S’applique uniquement à jpeg et webp.

backgroundstring· par défaut opaque· valeursopaquetransparentauto

Un fond transparent nécessite png ou webp ; jpeg ne gère pas la transparence.

moderationstring· valeursautolow

Degré de sévérité de la modération du contenu.

partial_imagesinteger· valeurs0–3

S’utilise avec stream: true : nombre d’images intermédiaires envoyées pendant la génération.

Erreurs courantes

ErreurCauseSolution
moderation_blockedLa consigne a été bloquée par le système de sécurité du fournisseur en amontModifiez la consigne puis réessayez ; réessayer sans changement donne le même résultat
Transparent background is not supported for JPEG output formatFond transparent demandé avec jpegUtilisez png ou webp
404 model_not_foundIdentifiant de modèle mal orthographié ou casse incorrecteCopiez l’identifiant de modèle depuis cette page
Invalid sizeLa taille enfreint l’une des quatre règles ci-dessusAjustez-la comme décrit dans Taille et qualité
does not support quality 'xhigh'xhigh ou max envoyé à gpt-image-2Utilisez high, ou passez à 2.5
Invalid value: 'standard'quality défini sur standard ou hdUtilisez une valeur de low à max
429 rate_limit_exceededPlus de 100 requêtes par minute (par équipe)Réessayez plus tard

Pour les autres erreurs, consultez le tableau complet des erreurs.

Documentation officielle

La documentation d’OpenAI décrit le comportement lors d’un appel direct à OpenAI. Lorsque vous passez par OfoxAI, les résultats mesurés dans ces pages font foi. Par exemple, il n’est pas nécessaire d’épingler un fournisseur pour l’édition.

Last updated on