Op den Inhalt sprangen

FLUX.3 Klein

Integréieren

Modell-ID blackforestlabs/flux-3/klein/text-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/blackforestlabs/flux-3/klein/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Dateie wéi am Beispill: 0,009 $ 9 API-Kreditter Är Dateie gi virun der Ausféierung gemooss Op dëser Säit ausféieren

API-Schlëssel kréien
Black Forest Labs Text zu Bild #image-generation#text-to-image#typography#graphic-design

Text-zu-Bild mat natierleche 4K-Gréissten, optionaler Bounding-Box-Layoutkontroll a bis zu 4 Biller pro Ufro

Black Forest Labs · Bild

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch

Instruktioune fir d'Bildgeneratioun, déi Thema, Kadreierung, Beliichtung an Hannergrond am Detail beschreiwen, entspriechend den detailléierte Captions, mat deenen de Modell trainéiert gouf.

image_size Standard square_hd

Setzt Breet an Héicht vum Output onofhängeg bannent 256–4096 Pixel; native 4K-Generatioun gëtt ënnerstëtzt.

num_images Standard 1

Ugefrote Bildzuel fir d'Generatioun.

Erweidert output_format · seed · enable_prompt_expansion · enable_safety_checker · bounding_boxes
output_format Standard png

Dateiformat vum resultéierende Bild.

Seed fir reproduzéierbar Biller: Dee selwechte Prompt a Seed produzéieren datselwecht Bild, wann d'Modellversioun onverännert ass.

Optional Këschtelayout, dat all beschriwwenen Objet op seng zougewisen Këscht limitéiert; identifizéiert Këschten iwwer Prompt-Etiketten, z. B. `A red fox <fox> sits under a red umbrella <umbrella>`. Koordinate drécken d'Këschtekante als Fraktioune vun de Bilddimensiounen aus, gemooss vum Ursprung uewen lénks (0, 0).

POST /run/blackforestlabs/flux-3/klein/text-to-image?wait=20 Präis → 0,009 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/blackforestlabs/flux-3/klein/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer FLUX.3 Klein

Generéiert Biller aus engem detailléierten Text-`prompt`. All Säit vun `image_size` kann tëscht 256 an 4096 Pixel leien, an Dir kënnt 1 bis 4 Biller pro Ufro froen. Bis zu 32 `bounding_boxes` erlaben et, benannt Objeten op feste Positiounen am Frame ze placéieren. D'Ausgab kann png, jpeg oder webp sinn; Prompt-Erweiderung kann un- oder ausgeschalt ginn.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
promptobligatoresch
Typstring
Instruktioune fir d'Bildgeneratioun, déi Thema, Kadreierung, Beliichtung an Hannergrond am Detail beschreiwen, entspriechend den detailléierte Captions, mat deenen de Modell trainéiert gouf.
enable_prompt_expansionoptional
Typboolean
Standardtrue
Prompt-Erweiderung zu enger detailléierter Caption virun der Generatioun, aktivéiert wann true. Beim Ännere baséiert d'Caption op de Referenzbiller.
seedoptional
Typinteger | null
Seed fir reproduzéierbar Biller: Dee selwechte Prompt a Seed produzéieren datselwecht Bild, wann d'Modellversioun onverännert ass.
num_imagesoptional num_outputs
Typinteger
Standard1
1 – 4
Ugefrote Bildzuel fir d'Generatioun.
enable_safety_checkeroptional
Typboolean
Standardtrue
Aktivéierung vun der Sécherheetskontroll; true aktivéiert d'Kontroll.
output_formatoptional
Typenum
Standardpng
jpegpngwebp
Dateiformat vum resultéierende Bild.
image_sizeoptional
Typobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Setzt Breet an Héicht vum Output onofhängeg bannent 256–4096 Pixel; native 4K-Generatioun gëtt ënnerstëtzt.
bounding_boxesoptional
Typobject[]
≤ 32 Elementer
Optional Këschtelayout, dat all beschriwwenen Objet op seng zougewisen Këscht limitéiert; identifizéiert Këschten iwwer Prompt-Etiketten, z. B. `A red fox <fox> sits under a red umbrella <umbrella>`. Koordinate drécken d'Këschtekante als Fraktioune vun de Bilddimensiounen aus, gemooss vum Ursprung uewen lénks (0, 0).
bounding_boxes[].labeloptional
Typstring | null
≤ 64 characters
Kuerzt Objektetikett fir d'Këscht, wéi `fox`; de Standard ass `obj_<n>`. Maacht `<fox>` an de Prompt, fir seng Wierder mat der Këscht ze verbannen; Këschten, déi net am Prompt ernimmt ginn, ginn der Szen bäigefüügt.
bounding_boxes[].descriptionobligatoresch
Typstring
≤ 500 characters
Objekt, dat an der Këscht gerendert gëtt, inklusiv sengem Ausgesinn.
bounding_boxes[].boxobligatoresch
Typobject
Objektplazéierung am Output-Bild.
bounding_boxes[].box.x_minobligatoresch
Typnumber
0 – 1
Lénks Grenz relativ zur Bildbreet, vun 0 bis 1.
bounding_boxes[].box.y_minobligatoresch
Typnumber
0 – 1
Uewescht Grenz relativ zur Bildhéicht, vun 0 bis 1.
bounding_boxes[].box.x_maxobligatoresch
Typnumber
0 – 1
Riets Grenz relativ zur Bildbreet, vun 0 bis 1.
bounding_boxes[].box.y_maxobligatoresch
Typnumber
0 – 1
Ënnescht Grenz relativ zur Bildhéicht, vun 0 bis 1.
obligatoresch Kanoneschen Numm, och akzeptéiert

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "blackforestlabs/flux-3/klein/text-to-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 9,
    "usd": "0.009",
    "charged": 9,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
images
array of object {url, content_type, file_name, file_size, width, height}Biller, déi vum Modell erstallt goufen.
timings
objectZäitinformatioun fir de Generatiounsprozess.
seed
integerGeneratiounsseed fir dat éischt Bild.
has_nsfw_concepts
array of booleanGëtt un, ob NSFW-Konzepter an de generéierte Biller optrieden.
prompt
stringPrompt, deen während der Bild-Generatioun benotzt gëtt.

Méi Modeller: Text zu Bild

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/blackforestlabs/flux-3/klein/text-to-image.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt