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

FLUX.1 Kontext [dev]

אינטעגרירן

מאָדעל־id flux-kontext/dev
# 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/flux-kontext/dev?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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.025⁩ 25 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Black Forest Labs · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

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

•פארלאנגט image_url
לייגט אַרײַן אַ טעקע, אָדער

בילד־URL פֿאַר רעדאַקטירן, מיט ברייט און הייך באַגרענעצט צו 14142px און אַ timeout פֿון 20 סעקונדעס.

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

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

פֿאָרגעשריטן output_format · acceleration · resolution_mode · num_inference_steps · guidance_scale · seed · enable_safety_checker
output_format סטאַנדאַרט jpeg

פֿאָרמאַט גענוצט פֿאַרן רעזולטאַט.

acceleration סטאַנדאַרט none

גענערירונג־אַקסעלעראַציע; העכערע באַשטעטיקונגען פֿאַרקלענערן די צײַט נייטיק צו גענערירן רעזולטאַטן.

סטאַנדאַרט match_input

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

סטאַנדאַרט 28

צאָל אינפֿערענץ־סטעפּס צו לויפֿן.

סטאַנדאַרט 2.5

שטאַרקייט פֿון פּראָמפּט־אנהאַלטונג פֿאַר בילד־אויסקלײַב, אויסגעדריקט ווי CFG (Classifier Free Guidance).

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

POST /run/flux-kontext/dev?wait=20 פּרײַז → ⁨$ 0.025⁩
# 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/flux-kontext/dev?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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.1 Kontext [dev]

עדיטירט אַ בילד פֿון `image_url` לויט אַ טעקסט־`prompt`. `resolution_mode` קען צופּאַסן דעם אַרײַנגאַנג, אויסקלײַבן אויטאָמאַטיש אָדער צווינגען אַ פּראָפּאָרציע ווי 16:9 אָדער 9:21. `acceleration` אָפפערט none, regular אָדער high, און דער מאָדעל שטיצט 10 ביז 50 טריט און ביז 4 רעזולטאַטן.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
פּראָמפּט וואָס באַשרײַבט די בילד־ענדערונגען.
image_urlפארלאנגט image
טיפּurl · image
בילד־URL פֿאַר רעדאַקטירן, מיט ברייט און הייך באַגרענעצט צו 14142px און אַ timeout פֿון 20 סעקונדעס.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט28
10 – 50
צאָל אינפֿערענץ־סטעפּס צו לויפֿן.
seedאָפּציאָנעל
טיפּinteger | null
סיד פֿאַר רעפּראָדוצירבאַרע בילדער: אַן אידענטישער פּראָמפּט און סיד שאַפֿן אַן אידענטיש בילד ווען די מאָדעל־ווערסיע איז אומגעענדערט.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט2.5
1 – 20
שטאַרקייט פֿון פּראָמפּט־אנהאַלטונג פֿאַר בילד־אויסקלײַב, אויסגעדריקט ווי CFG (Classifier Free Guidance).
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 4
געבעטן צאָל בילדער פֿאַר גענערירונג.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
זיכערקייט־קאָנטראָל, וואָס גיט שוואַרצע בילדער אַנשטאָט פון בילדער וואָס ווערן אָפּגעצייכנט ווי נישט זיכער. true דערמעגלעכט קאָנטראָל; false דיסייבלט עס בלויז פֿאַר אָטעריזירטע חשבונות, בשעת בקשות אָן אָטעריזאַציע ווערן סייַ ווי סייַ אָפּגעקוקט.
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטjpeg
jpegpng
פֿאָרמאַט גענוצט פֿאַרן רעזולטאַט.
accelerationאָפּציאָנעל
טיפּenum
סטאַנדאַרטnone
noneregularhigh
גענערירונג־אַקסעלעראַציע; העכערע באַשטעטיקונגען פֿאַרקלענערן די צײַט נייטיק צו גענערירן רעזולטאַטן.
resolution_modeאָפּציאָנעל
טיפּenum
סטאַנדאַרטmatch_input
automatch_input1:116:921:93:22:34:55:43:44:39:169:21
קלײַבן ווי בילד־רעדאַקטירן באַשטימט די רעזולטאַט־רעזאָלוציע: `match_input` פּרוּווט אָפּהיטן די אַרײַנגעבונג־דימענסיעס, אָבער אַדזשאַסטירט זיי לויט די מאָדעל־פֿאָדערונגען, אַרײַנגערעכנט מולטיפּלען פֿון 16 און געשטיצטע גרייס־לימיטן. פֿאַר רובֿ ניצונגען ווערט רעקאָמענדירט `auto`, ווײַל עס ניצט די רעזאָלוציעס אויף וועלכע דער מאָדעל איז טריינירט געוואָרן און קלײַבט די בעסטע פאַרשטעלטע גרייס פֿאַר דעם אַספּעקט־פֿאַרהעלטעניש פֿון דער אַרײַנגעבונג. עס זענען אויך בנימצא עטלעכע בפֿירושע אַספּעקט־פֿאַרהעלטענישן.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux-kontext/dev",
  "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": 25,
    "usd": "0.025",
    "charged": 25,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "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, width, height, content_type}פֿײַל־אינפֿאָרמאַציע פֿאַר די גענערירטע בילדער.
timings
object
seed
integerבילד־גענערירונג־סיד, אַרײַנגערעכנט דעם ראַנדאָם אויסגעקליבענעם ווערט אויב די אַרײַנגעבונג האט נישט אַרײַנגעגעבן קיין סיד; אַנדערש איבערחזרט עס דעם צוגעשטעלטן ווערט.
has_nsfw_concepts
array of booleanווײַזט צי NSFW־קאָנסעפּטן דערשײַנען אין די גענערירטע בילדער.
prompt
stringפּראָמפּט וואָס ווערט גענוצט בעת בילד־גענערירונג.

מער מאָדעלן: בילד־עדיטירונג

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