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

Z Image Turbo Inpaint

אינטעגרירן

מאָדעל־id z-image/turbo/inpaint
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/z-image/turbo/inpaint?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",
    "mask_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

דער דאָזיקער ריקוועסט: ≈⁨$ 0.03⁩ 30 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Alibaba · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

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

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

בילד־URL גענוצט ווי אַרײַנגעבונג פֿאַר אינפּיינטינג.

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

מאַסקע־URL גענוצט ווי אַרײַנגעבונג פֿאַר אינפּיינטינג.

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

דימענסיעס פֿונעם גענערירטן בילד.

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

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

פֿאָרגעשריטן output_format · acceleration · num_inference_steps · control_scale · control_start · control_end · strength · seed · enable_safety_checker · enable_prompt_expansion
output_format סטאַנדאַרט png

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

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

אַקסעלעראַציע־ניוואָ געווענדט צו פּראַסעסירונג.

סטאַנדאַרט 8

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

סטאַנדאַרט 0.75

שטאַרקייט פֿון דער קאָנדיציאָנירונג וואָס ControlNet אָנווענדט.

סטאַנדאַרט 0

אָנהייב־פּונקט פֿאַר ControlNet קאַנדיציאָנירונג.

סטאַנדאַרט 0.8

סוף־פּונקט פֿאַר ControlNet קאַנדיציאָנירונג.

סטאַנדאַרט 1

קאַנדיציאָנירונג־שטאַרקייט פֿאַר אינפּיינטינג.

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

POST /run/z-image/turbo/inpaint?wait=20 פּרײַז → ⁨$ 0.03⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/z-image/turbo/inpaint?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",
    "mask_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

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

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

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

וועגן Z Image Turbo Inpaint

רעדאַקטירט אַ טייל פֿון אַ בילד: צושטעלן `image_url`, אַ `mask_image_url` וואָס צייכנט אָן דעם געביט צו ענדערן, און אַ `prompt` וואָס באַשרײַבט וואָס צו גענערירן. `strength` און די קאָנטראָל־באַשטימונגען (`control_scale`, `control_start`, `control_end`) פּאַסן צו ווי נאָענט דער רעזולטאַט גייט נאָך דעם אָריגינאַל. עס לויפֿט ביז 8 אינפֿערענץ־שריט, גיט צוריק 1 ביז 4 בילדער, און קען אַרויסגעבן png, jpeg אָדער webp.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
פּראָמפּט וואָס פירט בילד־גענערירונג.
image_sizeאָפּציאָנעל
טיפּobject
סטאַנדאַרטauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
דימענסיעס פֿונעם גענערירטן בילד.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט8
1 – 8
צאָל אינפֿערענץ־סטעפּס צו לויפֿן.
seedאָפּציאָנעל
טיפּinteger | null
סיד פֿאַר רעפּראָדוצירבאַרע בילדער: אַן אידענטישער פּראָמפּט און סיד שאַפֿן אַן אידענטיש בילד ווען די מאָדעל־ווערסיע איז אומגעענדערט.
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 4
געבעטן צאָל בילדער פֿאַר גענערירונג.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
זיכערקייט־קאָנטראָל, וואָס גיט שוואַרצע בילדער אַנשטאָט פון בילדער וואָס ווערן אָפּגעצייכנט ווי נישט זיכער. true דערמעגלעכט קאָנטראָל; false דיסייבלט עס בלויז פֿאַר אָטעריזירטע חשבונות, בשעת בקשות אָן אָטעריזאַציע ווערן סייַ ווי סייַ אָפּגעקוקט.
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטpng
jpegpngwebp
פֿײַל־פֿאָרמאַט פון דעם רעזולטירנדיקן בילד.
accelerationאָפּציאָנעל
טיפּenum
סטאַנדאַרטregular
noneregularhigh
אַקסעלעראַציע־ניוואָ געווענדט צו פּראַסעסירונג.
enable_prompt_expansionאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
קאָנטראָלירט צי פּראָמפּט־יקספּאַנשאַן איז אַקטיווירט.
image_urlפארלאנגט image
טיפּurl · image
בילד־URL גענוצט ווי אַרײַנגעבונג פֿאַר אינפּיינטינג.
control_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.75
0 – 1
שטאַרקייט פֿון דער קאָנדיציאָנירונג וואָס ControlNet אָנווענדט.
control_startאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0
0 – 1
אָנהייב־פּונקט פֿאַר ControlNet קאַנדיציאָנירונג.
control_endאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.8
0 – 1
סוף־פּונקט פֿאַר ControlNet קאַנדיציאָנירונג.
mask_image_urlפארלאנגט
טיפּurl · image
מאַסקע־URL גענוצט ווי אַרײַנגעבונג פֿאַר אינפּיינטינג.
strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
≤ 1> 0
קאַנדיציאָנירונג־שטאַרקייט פֿאַר אינפּיינטינג.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "z-image/turbo/inpaint",
  "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": 30,
    "usd": "0.03",
    "charged": 30,
    "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",
    "mask_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",
        "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://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/z-image/turbo/inpaint.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt