Skip to main content
POST

Overzicht

POST /flux/v1/\{model\} verstuurt een systeemeigen afbeeldingstaak in BFL-indeling. Sla de id op uit het antwoord op hoofdniveau en poll vervolgens GET /flux/v1/get_result met die taak-ID. De API-playground bevat voorbeelden van tekst-naar-afbeeldingsverzoeken voor FLUX.2 Pro, Flex en Max. Raadpleeg de pagina Modellen of /v1/models voor model-ID’s en accountbeschikbaarheid.

Aanvraagvelden

Begin met prompt, width, height en output_format. Je kunt ook seed versturen; het voltooide resultaat kan de gebruikte seed melden, maar dat veld alleen zorgt niet voor reproduceerbare uitvoer. Voor bewerking met referentieafbeeldingen verstuur je een openbare HTTPS-afbeeldings-URL in input_image. Dit veld wordt ondersteund voor de drie bovenstaande FLUX.2-modellen. FLUX.2 Pro accepteert ook een tweede openbare HTTPS-URL in input_image_2; voeg altijd input_image toe wanneer je input_image_2 verstuurt.

Indienen en pollen

In het aanmaakantwoord kan status: "processing" staan terwijl de taak wordt uitgevoerd. Gebruik de id op hoofdniveau met het resultaatendpoint van CometAPI; clients mogen niet afhankelijk zijn van een door het antwoord opgegeven polling_url. Poll totdat het resultaatendpoint status: "Ready" retourneert. Beschouw Error, Failed, Failure, Task not found, Request Moderated en Content Moderated als fouten. Blijf voor andere statussen pollen binnen de limieten voor nieuwe pogingen en time-outs van je applicatie.
Wanneer een taak gereed is, is result.sample een tijdelijke afbeeldings-URL. Download of verplaats deze onmiddellijk; vertrouw niet op een vaste geldigheidsduur.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Padparameters

model
string
vereist

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

Body

application/json
prompt
string
vereist

Text prompt describing the image or reference-image edit.

Voorbeeld:

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

input_image
string

Public HTTPS URL of the first reference image. Replace the example URL with an image that the model provider can retrieve. This editing field is available for the FLUX.2 models covered by this reference.

Voorbeeld:

"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.

Voorbeeld:

"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.

Voorbeeld:

1280

height
integer

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

Voorbeeld:

768

output_format
string

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

Voorbeeld:

"png"

Respons

200 - application/json

FLUX task submission response. Save the top-level id and poll the CometAPI result endpoint.

id
string
vereist

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

status
string
vereist

Submission state. An accepted task can return processing.

result
object | null

Task result. It can be empty or null at submission time.

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.

Laatst gewijzigd op 31 juli 2026