שפּרינגען צו אינהאַלט

FLUX.3 Klein

אינטעגרירן

מאָדעל־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"

פֿײַלן ווי דער בײַשפּיל: ⁨$ 0.009⁩ 9 API־קרעדיטן אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Black Forest Labs טעקסט צו בילד #image-generation#text-to-image#typography#graphic-design

טעקסט־צו־בילד מיט נאַטיווע 4K גרייסן, אָפּציאָנעלער באַונדינג־באָקס־לייאַוט־קאָנטראָל און ביז 4 בילדער פּער ריקוועסט

Black Forest Labs · בילד

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט

בילד־גענערירונג־אינסטרוקציעס וואָס באַשרײַבן דעטאַלירט סוביעקט, קאַדירונג, ליכט און הינטערגרונט, אין איינקלאַנג מיט די דעטאַלירטע קעפּלעך אויף וועלכע דער מאָדעל איז אויסגעלערנט געוואָרן.

image_size סטאַנדאַרט square_hd

שטעל די רעזולטאַט־ברייט און הייך אומאָפּהענגיק אין 256–4096 פּיקסעלן, מיט שטיצע פֿאַר נאַטירלעכער 4K־גענערירונג.

num_images סטאַנדאַרט 1

געבעטן צאָל בילדער פֿאַר גענערירונג.

פֿאָרגעשריטן output_format · seed · enable_prompt_expansion · enable_safety_checker · bounding_boxes
output_format סטאַנדאַרט png

פֿײַל־פֿאָרמאַט פון דעם רעזולטירנדיקן בילד.

סיד פֿאַר רעפּראָדוצירבאַרע בילדער: אַן אידענטישער פּראָמפּט און סיד שאַפֿן אַן אידענטיש בילד ווען די מאָדעל־ווערסיע איז אומגעענדערט.

אָפּציאָנעלע אויסלייג מיט קעסטלעך וואָס באַגרענעצט יעדן באַשריבן אָביעקט צו זײַן צוגעטיילט קעסטל; אידענטיפֿיציר קעסטלעך דורך פּראָמפּט־לאַבעלס, למשל `A red fox <fox> sits under a red umbrella <umbrella>`. קאָאָרדינאַטן דריקן אויס קעסטל־ראַנדן ווי פֿראַקציעס פֿון די בילד־דימענסיעס, געמאסטן פֿון דער אויבערשטער לינקער אָריגין (0, 0).

POST /run/blackforestlabs/flux-3/klein/text-to-image?wait=20 פּרײַז → ⁨$ 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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן FLUX.3 Klein

גענערירט בילדער פֿון אַ דעטאַלירטן טעקסט־`prompt`. יעדער זײַט פֿון `image_size` קען לויפן פֿון 256 ביז 4096 פּיקסעלן, און מע קען בעטן 1 ביז 4 בילדער פּער רוף. ביז 32 `bounding_boxes` לאָזן שטעלן באַצייכנטע אָביעקטן אויף באַשטימטע פּאָזיציעס אינעם פֿריים. די אויסגאַבע קען זײַן png, jpeg אָדער webp, און פּראמפּט־יקספּאַנשאַן קען מען אָנצינדן אָדער אויסשליסן.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
בילד־גענערירונג־אינסטרוקציעס וואָס באַשרײַבן דעטאַלירט סוביעקט, קאַדירונג, ליכט און הינטערגרונט, אין איינקלאַנג מיט די דעטאַלירטע קעפּלעך אויף וועלכע דער מאָדעל איז אויסגעלערנט געוואָרן.
enable_prompt_expansionאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
פֿאַרברייטערונג פֿונעם פּראָמפּט אין אַ דעטאַלירטן קעפּל פֿאַר דער גענערירונג, אַקטיווירט ווען true. בײַ רעדאַקטירונג ווערט דאָס קעפּל געגרונטוועט אויף די רעפֿערענץ־בילדער.
seedאָפּציאָנעל
טיפּinteger | null
סיד פֿאַר רעפּראָדוצירבאַרע בילדער: אַן אידענטישער פּראָמפּט און סיד שאַפֿן אַן אידענטיש בילד ווען די מאָדעל־ווערסיע איז אומגעענדערט.
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 4
געבעטן צאָל בילדער פֿאַר גענערירונג.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אַקטיוואַציע פון זיכערקייט־קאָנטראָלער; true דערמעגלעכט קאָנטראָל.
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטpng
jpegpngwebp
פֿײַל־פֿאָרמאַט פון דעם רעזולטירנדיקן בילד.
image_sizeאָפּציאָנעל
טיפּobject
סטאַנדאַרטsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
שטעל די רעזולטאַט־ברייט און הייך אומאָפּהענגיק אין 256–4096 פּיקסעלן, מיט שטיצע פֿאַר נאַטירלעכער 4K־גענערירונג.
bounding_boxesאָפּציאָנעל
טיפּobject[]
≤ 32 ייטעמס
אָפּציאָנעלע אויסלייג מיט קעסטלעך וואָס באַגרענעצט יעדן באַשריבן אָביעקט צו זײַן צוגעטיילט קעסטל; אידענטיפֿיציר קעסטלעך דורך פּראָמפּט־לאַבעלס, למשל `A red fox <fox> sits under a red umbrella <umbrella>`. קאָאָרדינאַטן דריקן אויס קעסטל־ראַנדן ווי פֿראַקציעס פֿון די בילד־דימענסיעס, געמאסטן פֿון דער אויבערשטער לינקער אָריגין (0, 0).
bounding_boxes[].labelאָפּציאָנעל
טיפּstring | null
≤ 64 characters
קורצער אָביעקט־לאַבעל פֿאַרן קעסטל, ווי `fox`; דער סטאַנדאַרט איז `obj_<n>`. נעם אַרײַן `<fox>` אינעם פּראָמפּט צו פֿאַרבינדן זײַנע ווערטער מיטן קעסטל; קעסטלעך וואָס ווערן נישט דערמאָנט אינעם פּראָמפּט ווערן צוגעגעבן צו דער סצענע.
bounding_boxes[].descriptionפארלאנגט
טיפּstring
≤ 500 characters
אָביעקט צו רענדערן אינעם קעסטל, אַרײַנגערעכנט זײַן אויסזען.
bounding_boxes[].boxפארלאנגט
טיפּobject
אָביעקט־פּלאַץ אינעם רעזולטאַט־בילד.
bounding_boxes[].box.x_minפארלאנגט
טיפּnumber
0 – 1
לינקע גרענעץ אויסגעדריקט רעלאַטיוו צו דער בילד־ברייט, פֿון 0 ביז 1.
bounding_boxes[].box.y_minפארלאנגט
טיפּnumber
0 – 1
אויבערשטער גרענעץ אויסגעדריקט רעלאַטיוו צו דער בילד־הייך, פֿון 0 ביז 1.
bounding_boxes[].box.x_maxפארלאנגט
טיפּnumber
0 – 1
רעכטע גרענעץ אויסגעדריקט רעלאַטיוו צו דער בילד־ברייט, פֿון 0 ביז 1.
bounding_boxes[].box.y_maxפארלאנגט
טיפּnumber
0 – 1
נידעריקערע גרענעץ אויסגעדריקט רעלאַטיוו צו דער בילד־הייך, פֿון 0 ביז 1.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

אויסגאַבע

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"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
images
array of object {url, content_type, file_name, file_size, width, height}בילדער געשאַפֿן דורך דעם מאָדעל.
timings
objectצײַט־אינפֿאָרמאַציע פֿאַרן גענערירונג־פּראָצעס.
seed
integerגענערירונג־סיד פֿאַרן ערשטן בילד.
has_nsfw_concepts
array of booleanווײַזט צי NSFW־קאָנסעפּטן דערשײַנען אין די גענערירטע בילדער.
prompt
stringפּראָמפּט וואָס ווערט גענוצט בעת בילד־גענערירונג.

מער מאָדעלן: טעקסט צו בילד

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/blackforestlabs/flux-3/klein/text-to-image.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt