Generer et FLUX-bilde

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

Oversikt

POST /flux/v1/\{model\} genererer et bilde med en forespørsel i opprinnelig BFL-format. Forespørsler er asynkrone som standard. Lagre toppnivåverdien id fra svaret, og foreta deretter polling GET /flux/v1/get_result med den oppgave-ID-en. For å vente på bildet i samme forespørsel, send "async": false i JSON-brødteksten. Et vellykket synkront svar inneholder status: "Ready" og bilde-URL-en i result.sample. API-lekeplassen inneholder eksempler på tekst-til-bilde-forespørsler for FLUX.2 Pro, Flex og Max. Se Models-siden eller /v1/models for modell-ID-er og kontotilgjengelighet.

Forespørselsfelt

Start med prompt, width, height og output_format. Du kan også sende seed; det fullførte resultatet kan rapportere seed-verdien som ble brukt, men dette feltet alene gir ikke repeterbart resultat. Det valgfrie feltet async styrer hvordan forespørselen returnerer resultatet. Bruk den boolske JSON-verdien false for synkron generering. Bruk true eller utelat feltet for asynkron generering. Ikke send en streng som "false". For redigering med referansebilder sender du en offentlig HTTPS-bilde-URL i input_image. Dette feltet støttes av de tre FLUX.2-modellene ovenfor. FLUX.2 Pro godtar også en andre offentlig HTTPS-URL i input_image_2; ta med input_image hver gang du sender input_image_2.

Generer synkront

Velg Synkron tekst-til-bilde (FLUX.2 Pro) i forespørselseksemplene for å sende "async": false. Hold tilkoblingen åpen mens bildet genereres. Eksemplet bruker en klienttidsavbruddsgrense på 300 sekunder; dette er en klientinnstilling, ikke en frist for fullføring. Når svaret har status: "Ready", leser du result.sample direkte. Det er ikke nødvendig å polle resultatet. Hvis forespørselen mislykkes, må du håndtere HTTP-feilen før du leser resultatet. Ikke kombiner async: false med webhook_url eller webhook_secret. Synkrone forespørsler returnerer resultatet direkte og avviser disse webhook-feltene.

Send inn asynkront og poll

Når async er true eller utelates, returnerer opprettelsessvaret en oppgave-ID mens genereringen fortsetter. Bruk verdien id på toppnivå med CometAPI-resultatendepunktet; klienter bør ikke være avhengige av en polling_url som oppgis i svaret. Poll til resultatendepunktet returnerer status: "Ready". Behandle Error, Failed, Failure, Task not found, Request Moderated og Content Moderated som feil. For andre tilstander fortsetter du å polle innenfor programmets grenser for nye forsøk og tidsavbrudd.

Når en oppgave er klar, er result.sample en midlertidig bilde-URL. Last den ned eller overfør den umiddelbart; ikke stol på en fast levetid.

Autorisasjoner

Authorization

string

header

påkrevd

Bearer token authentication. Use your CometAPI key.

Stien-parametere

model

string

påkrevd

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

Kropp

application/json

prompt

string

påkrevd

Text prompt describing the image or reference-image edit.

Eksempel:

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

async

boolean

standard: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.

Eksempel:

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

Eksempel:

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

Eksempel:

1280

height

integer

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

Eksempel:

768

output_format

string

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

Eksempel:

"png"

Svar

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

påkrevd

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

status

string

påkrevd

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.

Sist endret 21. september 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>"
}

Innholdsmoderering

API-nøkler

Oversikt

Forespørselsfelt

Generer synkront

Send inn asynkront og poll

Autorisasjoner

Stien-parametere

Kropp

Svar

​Oversikt

​Forespørselsfelt

​Generer synkront

​Send inn asynkront og poll

Autorisasjoner

Stien-parametere

Kropp

Svar

Oversikt

Forespørselsfelt

Generer synkront

Send inn asynkront og poll