Passer au contenu principal
POST
Créer une image
Crée une ou plusieurs images à partir d’une consigne textuelle.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Corps

application/json
model
string
requis
prompt
string
requis
models
string[]

Modèles de repli facultatifs et ordonnés, essayés après model. model est obligatoire et reste toujours le modèle principal. Lorsqu'une tentative échoue avec 429, 500, 502, 503 ou 504, l'entrée suivante est essayée ; les autres erreurs sont renvoyées telles quelles. Accepte jusqu'à 25 identifiants de modèle ou préréglages ; les doublons et les entrées identiques à model sont ignorés. Chaque tentative est validée, journalisée et facturée comme une requête distincte, et le champ model de la réponse ainsi que la trace de routage indiquent le modèle qui a servi la requête. Les requêtes en streaming ne basculent qu'avant le premier octet, et les tâches vidéo et musique uniquement lors de leur soumission. Les requêtes batch, realtime et council rejettent models. Les replis définis sur une route dynamique sont prioritaires, et phaseo/auto ne peut pas être combiné avec models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemple:
size
string
resolution
string
n
integer
Plage requise: 1 <= x <= 10
quality
string
stream
boolean
partial_images
integer
Plage requise: 0 <= x <= 3
output_format
enum<string>

Format de sortie. gif et svg nécessitent un modèle GPT Image 2.6 et ne prennent pas en charge stream ni partial_images. svg nécessite aussi svg.model et n=1.

Options disponibles:
png,
jpeg,
webp,
gif,
svg
output_compression
integer
Plage requise: 0 <= x <= 100
background
enum<string>
Options disponibles:
transparent,
opaque,
auto
moderation
enum<string>
Options disponibles:
auto,
low
complexity
enum<string>
Options disponibles:
low,
medium,
high
frame_count
integer
Plage requise: 2 <= x <= 64
frame_duration_ms
integer
Plage requise: 20 <= x <= 2000
svg
object

Obligatoire lorsque output_format vaut svg. svg.model est le modèle de texte OpenAI qui écrit le SVG à partir de l’image de référence. Ses tokens sont facturés aux prix texte de ce modèle, les tokens de raisonnement comptant comme sortie, en plus du coût de l’image.

response_format
string
style
string
user
string
provider
object

Préférences de routage des fournisseurs pour la sélection par la passerelle.

Réponse

Réponse de génération d’image

created
integer
data
object[]
svg_usage
object
Dernière modification le 16 novembre 2026