Passer au contenu principal
POST
/
flux
/
v1
/
{model}
flux generate image
curl --request POST \
  --url https://api.cometapi.com/flux/v1/{model} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Hello"
}
'
{
  "id": "<string>",
  "polling_url": "<string>"
}

​
Vue d’ensemble

Le endpoint /flux/v1/\{model\} génère des images de haute qualité à partir de prompts textuels à l’aide de la famille de modèles Flux de Black Forest Labs. Il suffit de remplacer le nom du modèle dans le chemin de l’URL pour basculer entre les différentes variantes de Flux.
En raison de différences importantes dans les listes de paramètres selon les modèles de la série Flux, veuillez consulter la documentation officielle pour des instructions d’utilisation détaillées. La liste des paramètres fournie ici est donnée à titre de référence uniquement.Après la génération, utilisez le endpoint /flux/v1/get_result pour interroger les images générées ou surveiller le statut du processus.Les URL d’images renvoyées par le service de BFL expirent au bout d’environ 10 minutes. Enregistrez rapidement les résultats générés.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

En-têtes

​
Content-Type
string

Must be application/json.

Paramètres de chemin

​
model
string
requis

Flux model variant to use, e.g. flux-pro-1.1, flux-pro, flux-dev, flux-pro-1.1-ultra.

Corps

application/json
​
prompt
string
défaut:Hello
requis

Text prompt describing the image to generate.

​
image_prompt
string

URL of a reference image to guide the generation style or content.

​
width
integer

Output image width in pixels. Must be a multiple of 32. Range varies by model.

​
height
integer

Output image height in pixels. Must be a multiple of 32. Range varies by model.

​
steps
integer

Number of diffusion steps. Higher values improve quality but increase latency.

​
prompt_upsampling
boolean

When true, automatically enhances the prompt for more detailed results.

​
seed
integer

Random seed for reproducible outputs. Omit for random generation.

​
guidance
number

Guidance scale controlling how closely the output follows the prompt. Higher values increase prompt adherence.

​
safety_tolerance
integer

Safety filter tolerance level. Higher values are more permissive. Range: 0–6.

​
interval
integer

Diversity interval. Higher values produce more varied outputs at the cost of prompt adherence.

​
output_format
string

Output image format. Supported values: jpeg, png.

​
webhook_url
string

URL to receive a POST notification when the task completes.

​
webhook_secret
string

Secret string included in webhook payloads for request verification.

Réponse

200 - application/json

OK

​
id
string
​
polling_url
string