Skip to main content
POST

Modèles pris en charge

Les trois modèles prennent en charge la génération texte-vers-image et la génération à partir d’images de référence.

Authentification

string
requis
Tous les points de terminaison nécessitent une authentification par jeton Bearer.Obtenez une clé API sur la page Gestion des clés API, puis ajoutez-la à l’en-tête de la requête :

Corps de la requête

string
requis
Nom du modèle :
  • flux-2-flex
  • flux-2-pro
  • flux-2-max
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 de l’image à générer ou de la modification à appliquer aux images de référence.
string
défaut:"2MP"
Préréglage de résolution de sortie. Valeurs prises en charge :
  • 1MP
  • 2MP (valeur par défaut)
  • 3MP
  • 4MP
Ici, 1MP correspond à 1,048,576 pixels.Les anciens alias restent acceptés : 512 / 512P / 1M correspondent à 1MP, 1K / 1024 à 2MP, 2K / 2048 à 3MP et 4K à 4MP. Toute autre valeur fait échouer la tâche.Ce préréglage détermine les dimensions de sortie lorsque size est un rapport d’aspect.
string
défaut:"1:1"
Rapport d’aspect ou dimensions en pixels de l’image de sortie.size accepte également auto : lorsque image_urls est fourni, le rapport d’aspect de l’image de référence est repris tout en conservant le niveau resolution actuel ; sans image de référence, la valeur par défaut 1:1 est utilisée.Options de taille prises en charge :
  • 1:1 (valeur par défaut)
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
  • 21:9
  • 9:21
  • auto - suivre le rapport d’aspect de l’image de référence
Vous pouvez également fournir une chaîne de dimensions telle que 1024x1536. Les dimensions exactes en pixels sont soumises aux mêmes limites que width et height et sont prioritaires sur resolution et le rapport d’aspect.
integer
Largeur de sortie exacte en pixels. Elle doit être fournie avec height, et chaque dimension doit être d’au moins 64 pixels. Fournir une seule dimension fait échouer la tâche.Une paire complète width et height est prioritaire et remplace resolution et size.
integer
Hauteur de sortie exacte en pixels. Elle doit être fournie avec width, et chaque dimension doit être d’au moins 64 pixels. Fournir une seule dimension fait échouer la tâche.L’image de sortie ne doit pas dépasser 4 MP (width × height ≤ 4,194,304) et le total formé par l’image de sortie et toutes les images de référence ne doit pas dépasser 9 MP.
array
Images de référence utilisées pour la génération à partir d’images. Les URL d’images accessibles publiquement et les entrées Base64 sont prises en charge.
  • Maximum : 8 images
  • Le total formé par l’image de sortie et toutes les images de référence ne doit pas dépasser 9 MP
string
défaut:"jpeg"
Format d’encodage de l’image de sortie. Valeurs prises en charge : jpeg, png et webp.
integer
défaut:"1"
Nombre d’images générées par tâche. La seule valeur prise en charge est 1 ; soumettez plusieurs tâches en parallèle si vous avez besoin de plusieurs images.
integer
Graine aléatoire. Réutilisez la même graine et les mêmes paramètres pour obtenir un résultat reproductible ; omettez-la pour utiliser une graine aléatoire.
boolean
défaut:"false"
Indique s’il faut enrichir et reformuler le prompt avant la génération. La valeur par défaut est false. Transmettez explicitement false pour désactiver la reformulation du prompt.
integer
défaut:"2"
Tolérance de sécurité comprise entre 0 et 5. Une valeur élevée est plus permissive.
integer
défaut:"50"
Nombre d’étapes d’échantillonnage, de 1 à 50. Une valeur élevée peut améliorer les détails, mais augmente le temps de traitement.Ce paramètre est uniquement pris en charge par flux-2-flex. Ne l’envoyez pas avec flux-2-pro ou flux-2-max.
number
défaut:"5.0"
Niveau de guidage du prompt, de 1.5 à 10. Une valeur élevée suit plus fidèlement le prompt.Ce paramètre est uniquement pris en charge par flux-2-flex. Ne l’envoyez pas avec flux-2-pro ou flux-2-max.

Tableau de référence des résolutions

L’ordre de priorité des dimensions est le suivant : paire width + heightsize sous forme de dimensions en pixels → resolution + rapport d’aspect size → valeur par défaut 2MP + 1:1.

Exemples d’utilisation

Génération texte-vers-image

Génération à partir d’images de référence

Dimensions de sortie exactes

Réglages de FLUX.2 Flex

Réponse

integer
Code d’état de la réponse.
array
Tableau contenant le résultat de la soumission.

Récupérer le résultat

Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne l’état completed ou failed. Consultez l’API d’état des tâches pour connaître le schéma complet de la réponse. États de la tâche : Une tâche terminée contient une image générée :
L’URL de l’image se trouve dans data.result.images[0].url[0]. Sa date d’expiration est définie par l’horodatage Unix data.result.images[0].expires_at ; téléchargez l’image avant cette échéance.

Paramètres non valides et tâches en échec

Les paramètres de modèle non valides ne produisent pas de réponse 4xx synchrone. La soumission renvoie tout de même HTTP 200 avec un task_id ; poursuivez l’interrogation jusqu’à l’état failed, puis consultez la raison précise dans data.error.message. Les tâches en échec sont intégralement remboursées.
error.code vaut toujours task_failed ; la raison précise se trouve dans error.message.

Remarques

  1. Les tâches sont traitées de manière asynchrone. La réponse à la soumission renvoie un task_id permettant d’interroger leur état.
  2. n vaut 1 par défaut et c’est la seule valeur prise en charge.
  3. Les images de référence peuvent être fournies via des URL accessibles publiquement ou en Base64.
  4. Jusqu’à 8 images de référence sont prises en charge, dans la limite totale de 9 MP pour les images d’entrée et de sortie.
  5. Les dimensions de sortie exactes peuvent être définies avec un size en pixels, ou avec width et height fournis ensemble. Dans ce second cas, chaque dimension doit être d’au moins 64 pixels ; la sortie est limitée à 4 MP.
  6. L’expiration de l’URL du résultat est déterminée par la valeur expires_at renvoyée dans la réponse de la tâche.
  7. Les paramètres de modèle non valides sont renvoyés de manière asynchrone : interrogez la tâche jusqu’à failed, puis consultez data.error.message.