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

Mai Image 2.5

אינטעגרירן

מאָדעל־id microsoft/mai-image-2.5/edit
# 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/microsoft/mai-image-2.5/edit?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",
    "images": [
      "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.057⁩ 57 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Microsoft בילד־עדיטירונג #realism#typography#stylized

סטאַנדאַרט MAI Image 2.5 עדיטאָר וואָס נעמט פּונקט איין אַרײַנגאַנג־בילד פּלוס אַן עדיט־אינסטרוקציע

Microsoft · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט 88 / 5000

רעדאַקטיר־אינסטרוקציעס פֿאַר דעם צוגעשטעלטן בילד אָדער בילדער.

•פארלאנגט image_urls
לייגט אַרײַן אַ טעקע, אָדער · ביז 1

בילד צו רעדאַקטירן, צוגעשטעלט ווי איין http(s) URL אָדער data: URL.

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

פּראָפּאָרציעס פונעם רעזולטאַט־בילד; "auto" פֿאָלגט אָדער די אַרײַנגעבונגס־פּראָפּאָרציעס אָדער לאָזט דעם מאָדעל אויסקלײַבן.

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

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

פֿאָרגעשריטן output_format
output_format סטאַנדאַרט png

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

POST /run/microsoft/mai-image-2.5/edit?wait=20 פּרײַז → ⁨$ 0.057⁩
# 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/microsoft/mai-image-2.5/edit?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",
    "images": [
      "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 שליסל

וועגן Mai Image 2.5

עדיטירט אַ בילד פֿון אַ טעקסט־אינסטרוקציע פֿון ביז 5000 צייכנס. `image_urls` איז נייטיק און אַנטהאַלט פּונקט איין http(s) אָדער data URL. קלייבט 1 ביז 4 רעזולטאַטן, אַן אַספּעקט־ראַטיאָ (auto פּאַסט זיך צום אַרײַנגאַנג), און jpeg, png אָדער webp פֿאָרמאַט.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
≤ 5,000 כאַראַקטערן≥ 3 כאַראַקטערן
רעדאַקטיר־אינסטרוקציעס פֿאַר דעם צוגעשטעלטן בילד אָדער בילדער.
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 4
געבעטן צאָל בילדער פֿאַר גענערירונג.
aspect_ratioאָפּציאָנעל
טיפּenum
סטאַנדאַרטauto
auto1:14:33:416:99:163:22:3
פּראָפּאָרציעס פונעם רעזולטאַט־בילד; "auto" פֿאָלגט אָדער די אַרײַנגעבונגס־פּראָפּאָרציעס אָדער לאָזט דעם מאָדעל אויסקלײַבן.
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטpng
jpegpngwebp
פֿײַל־פֿאָרמאַט פון דעם רעזולטירנדיקן בילד.
image_urlsפארלאנגט images
טיפּurl[] · image
≤ 1 ייטעם
בילד צו רעדאַקטירן, צוגעשטעלט ווי איין http(s) URL אָדער data: URL.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "microsoft/mai-image-2.5/edit",
  "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": 57,
    "usd": "0.057",
    "charged": 57,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "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
      }
    ],
    "description": "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}בילדער וואָס קומען אַרויס פון עדיטירונג.
description
stringבאַשרײַבונג וואָס באַגלייט די גענערירטע בילדער.

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

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