Générer une image FLUX

POST

flux

{model}

curl https://api.cometapi.com/flux/v1/flux-2-pro \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A clean editorial photograph of a red ceramic teapot on a pale blue table, a small yellow lemon on the right, soft window light, no text.",
    "seed": 424242,
    "width": 1280,
    "height": 768,
    "output_format": "png"
  }'

{
  "id": "<task_id>",
  "status": "Pending",
  "result": {},
  "polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}

Vue d’ensemble

POST /flux/v1/\{model\} génère une image avec une requête au format BFL natif. Les requêtes sont asynchrones par défaut. Stockez le id de la réponse de premier niveau, puis interrogez GET /flux/v1/get_result avec cet ID de tâche. Pour attendre l’image dans la même requête, envoyez "async": false dans le corps JSON. Une réponse synchrone réussie contient status: "Ready" et l’URL de l’image dans result.sample. L’API playground comprend des exemples de requêtes de texte vers image pour FLUX.2 Pro, Flex et Max. Consultez la page Modèles ou /v1/models pour connaître les ID de modèles et la disponibilité du compte.

Champs de requête

Commencez par prompt, width, height et output_format. Vous pouvez également envoyer seed ; le résultat final peut indiquer la seed utilisée, mais ce champ seul ne garantit pas une sortie reproductible. Le champ facultatif async contrôle le mode de retour de la requête. Utilisez le booléen JSON false pour une génération synchrone. Utilisez true ou omettez le champ pour une génération asynchrone. N’envoyez pas de chaîne telle que "false". Pour la modification d’images de référence, envoyez une URL d’image HTTPS publique dans input_image. Ce champ est pris en charge par les trois modèles FLUX.2 ci-dessus. FLUX.2 Pro accepte également une seconde URL HTTPS publique dans input_image_2 ; incluez input_image chaque fois que vous envoyez input_image_2.

Générer de manière synchrone

Sélectionnez Texte vers image synchrone (FLUX.2 Pro) dans les exemples de requêtes pour envoyer "async": false. Gardez la connexion ouverte pendant la génération de l’image. L’exemple utilise un délai d’expiration côté client de 300 secondes ; il s’agit d’un paramètre client, et non d’une échéance de finalisation. Lorsque la réponse contient status: "Ready", lisez directement result.sample. Aucune interrogation du résultat n’est nécessaire. Si la requête échoue, gérez l’erreur HTTP avant de lire le résultat. Ne combinez pas async: false avec webhook_url ou webhook_secret. Les requêtes synchrones renvoient directement le résultat et rejettent ces champs de webhook.

Soumettre de manière asynchrone et interroger

Lorsque async est défini sur true ou est omis, la réponse de création renvoie un ID de tâche pendant que la génération se poursuit. Utilisez son id de premier niveau avec le point de terminaison de résultat CometAPI ; les clients ne doivent pas dépendre d’un polling_url fourni dans la réponse. Interrogez jusqu’à ce que le point de terminaison de résultat renvoie status: "Ready". Considérez Error, Failed, Failure, Task not found, Request Moderated et Content Moderated comme des échecs. Pour les autres états, continuez l’interrogation dans les limites de tentatives et de délai d’expiration de votre application.

Lorsqu’une tâche est prête, result.sample est une URL d’image temporaire. Téléchargez-la ou transférez-la rapidement ; ne vous fiez pas à une durée de validité fixe.

Autorisations

Authorization

string

header

requis

Bearer token authentication. Use your CometAPI key.

Paramètres de chemin

model

string

requis

FLUX.2 model ID in the URL path. Check /v1/models or the Models page for account availability.

Corps

application/json

prompt

string

requis

Text prompt describing the image or reference-image edit.

Exemple:

"A clean editorial photograph of a red ceramic teapot on a pale blue table, soft window light, no text."

async

boolean

défaut:true

Controls whether generation returns asynchronously. Set false to wait for the finished image and read result.sample from the successful response. Set true or omit this field to receive a task ID for polling. Use a JSON boolean, not a string. Do not combine false with webhook_url or webhook_secret.

input_image

string

Public HTTPS URL of the first reference image. Replace the example URL with a publicly accessible image. This editing field is available for the FLUX.2 models covered by this reference.

Exemple:

"https://your-image-host/reference-one.jpg"

input_image_2

string

Public HTTPS URL of a second reference image for flux-2-pro. Replace the example URL and also send input_image.

Exemple:

"https://your-image-host/reference-two.jpg"

seed

integer

Optional seed value. A completed result can report the used seed; that field alone does not establish repeatable output.

width

integer

Requested output width in pixels. Use a dimension supported by the selected model.

Exemple:

1280

height

integer

Requested output height in pixels. Use a dimension supported by the selected model.

Exemple:

768

output_format

string

Requested output image format supported by the selected model. The examples use png.

Exemple:

"png"

Réponse

200 - application/json

With async: false, successful generation returns status: "Ready" and the image URL in result.sample. With async: true or no async field, save the top-level id and poll the CometAPI result endpoint.

string

requis

Task ID to pass to GET /flux/v1/get_result?id=....

status

string

requis

Task state. A successful synchronous response returns Ready. An asynchronous submission can return Pending while generation continues.

result

object | null

Generation result. A successful synchronous response contains the finished image. An asynchronous submission can return an empty or null result.

Show child attributes

polling_url

string | null

Response-supplied convenience URL when returned. Clients should poll the documented CometAPI result route by the top-level id.

cost

number | null

Numeric billing coefficient when returned. This field is not documented as a currency or credit amount.

input_mp

number | null

Input image megapixels when returned.

output_mp

number | null

Output image megapixels when returned.

progress

number | null

Task progress when returned.

details

any

Additional task details when returned.

preview

any

Task preview data when returned.

Dernière modification le 21 septembre 2026

curl https://api.cometapi.com/flux/v1/flux-2-pro \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A clean editorial photograph of a red ceramic teapot on a pale blue table, a small yellow lemon on the right, soft window light, no text.",
    "seed": 424242,
    "width": 1280,
    "height": 768,
    "output_format": "png"
  }'

{
  "id": "<task_id>",
  "status": "Pending",
  "result": {},
  "polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}

Modération de contenu

Clés API

Vue d’ensemble

Champs de requête

Générer de manière synchrone

Soumettre de manière asynchrone et interroger

Autorisations

Paramètres de chemin

Corps

Réponse

​Vue d’ensemble

​Champs de requête

​Générer de manière synchrone

​Soumettre de manière asynchrone et interroger

Autorisations

Paramètres de chemin

Corps

Réponse

Vue d’ensemble

Champs de requête

Générer de manière synchrone

Soumettre de manière asynchrone et interroger