Skip to main content
POST

Modèles pris en charge

Autorisations

string
requis
Toutes les requêtes API nécessitent une authentification Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez ce qui suit aux en-têtes de votre requête :

Body

string
requis
Nom du modèle
  • gpt-image-1-official — Priorité à la stabilité, adapté à la génération d’images générale
  • gpt-image-1.5-official — Nouvelle version, adaptée à une qualité supérieure et à l’édition complexe
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche d’image.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Description textuelle pour la génération d’images, prend en charge à la fois le chinois et l’anglais
string
défaut:"1:1"
Ratio d’aspectRatios pris en charge :
  • 1:1 — Carré (par défaut)
  • 3:2 — Paysage
  • 2:3 — Portrait
integer
défaut:"1"
Nombre d’images à générerPlage : 1-4
  • Les valeurs ≤ 0 seront traitées comme 1
  • Les valeurs > 4 seront traitées comme 4
Avertissement : Doit être un nombre brut (par exemple 1), sans guillemets, sinon une erreur sera renvoyée
string
défaut:"auto"
Qualité de l’image
  • auto — Sélection automatique de la qualité (par défaut)
  • low — Plus rapide, plus économique
  • medium — Équilibre entre qualité et coût
  • high — Qualité supérieure, coût plus élevé
string
défaut:"auto"
Mode d’arrière-plan
  • auto — Arrière-plan automatique (par défaut)
  • opaque — Arrière-plan opaque
  • transparent — Arrière-plan transparent, recommandé avec le format de sortie png
background: transparent ne peut pas être utilisé simultanément avec output_format: jpeg
string
défaut:"auto"
Niveau de modération
  • auto — Niveau de modération par défaut
  • low — Modération plus permissive
string
défaut:"png"
Format de sortie
  • png — Format par défaut, adapté aux arrière-plans transparents
  • jpeg — Taille de fichier plus petite, adapté à la sortie d’images générale
background: transparent ne peut pas être utilisé simultanément avec output_format: jpeg
integer
Niveau de compression de sortie, plage 0-100
  • Recommandé uniquement pour jpeg
  • Non recommandé pour png
array
Tableau d’URL d’images de référence, active le mode image-vers-image lorsqu’il est fourniLimite : Jusqu’à 15 images de référence
string
URL de l’image de masque pour l’inpainting
  • Doit être utilisé conjointement avec image_urls
  • Sera soumis via l’API d’édition officielle
  1. Avant de téléverser l’image de masque, veuillez confirmer que le canal Alpha de l’image est « Oui ».
  2. La taille de l’image de masque doit correspondre à la première image de référence.

Référence des tailles

Les ratios d’aspect sont utilisés en externe ; le système les associe automatiquement aux dimensions officielles en interne.

Exemples d’utilisation

Texte-vers-image (minimal)
Texte-vers-image (paramètres complets)
Image-vers-image (référence unique)
Image-vers-image (fusion multi-références)
Plusieurs images (n > 1)

Response

integer
Code de statut de la réponse
array
Tableau de données de réponse

Notes

  1. Traitement asynchrone : Après soumission, un task_id est renvoyé. Interrogez /v1/tasks/{task_id} pour obtenir les résultats
  2. Sélection du modèle : Utilisez gpt-image-1-official pour la génération d’images générale ; utilisez gpt-image-1.5-official pour l’édition de haute qualité et les tâches image-vers-image complexes
  3. Exigences relatives aux URL d’images : Pour image-vers-image, utilisez des URL d’images publiquement accessibles et stables
  4. Facturation : Facturé pour chaque image générée avec succès ; aucun frais en cas d’échec