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

Hidream O1 Image · Edit

אינטעגרירן

מאָדעל־id hidream-o1-image/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/hidream-o1-image/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.04⁩ 40 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
HiDream בילד־עדיטירונג רעפֿערענץ־אײַנגאַבעס

רעפֿערענץ־בילד־עדיטירונג און סוביעקט־פּערסאָנאַליזאַציע מיט פולער קוואַליטעט, ביז בערך 2048x2048, 50 טריט

HiDream · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

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

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

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

image_size סטאַנדאַרט {"height":2048,"width...

קלײַבט בילד־דימענסיעס; פֿאַר רעזולטאַטן באַזירט אויף רעפֿערענץ־בילדער ווערט די בקשה צוגעפּאַסט צו דער נענסטער רעזאָלוציע וואָס דער מאָדעל שטיצט, מיט אַן דערנענטערטן מאַקסימום פֿון 2048 × 2048 פּיקסעלן.

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

צאָל בילדער צו שאַפֿן.

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

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

סטאַנדאַרט 50

צאָל דענויזינג־טריט וואָס זאָלן דורכגעפֿירט ווערן.

סטאַנדאַרט 5

סקאַלע פֿאַר classifier-free guidance; סטאַנדאַרט איז 5.0 פֿאַרן פולן מאָדעל.

צופֿעליקער סיד וואָס מאכט די גענערירונג רעפּראָדוצירבאַר.

POST /run/hidream-o1-image/edit?wait=20 פּרײַז → ⁨$ 0.04⁩
# 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/hidream-o1-image/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 שליסל

וועגן Hidream O1 Image · Edit

עדיטירט בילדער אָדער בויט סוביעקט־געטריבענע רעזולטאַטן פֿון איין אָדער מער רעפֿערענץ־בילדער (`reference_image_urls`) פּלוס אַ טעקסט־`prompt`. די רעזולטאַט־גרייס ניצט פּרעסעטן אָדער אַן אייגענע גרייס, ביז בערך 2048x2048. לויטן באַשטעטיקטן ווערט ניצט עס 50 דענאָיזינג־טריט מיט guidance 5, און קען צוריקגעבן 1 ביז 4 בילדער ווי PNG, JPEG אָדער WebP. `keep_original_aspect` היט די אַספּעקט־פּראָפּאָרציע ווען מען גיט איין רעפֿערענץ.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
טעקסט־אינסטרוקציעס פֿאַר שאַפֿן אָדער רעדאַקטירן בילדער, אָדער פֿאַר סוביעקט־געטריבענער פּערסאָנאַליזאַציע.
reference_image_urlsפארלאנגט images
טיפּurl[] · image
בילדער צוגעשטעלט ווי רעפֿערענצן פֿאַר רעדאַקטירונג אָדער סוביעקט־געטריבענער פּערסאָנאַליזאַציע.
image_sizeאָפּציאָנעל
טיפּobject
סטאַנדאַרט{"height":2048,"width":2048}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
קלײַבט בילד־דימענסיעס; פֿאַר רעזולטאַטן באַזירט אויף רעפֿערענץ־בילדער ווערט די בקשה צוגעפּאַסט צו דער נענסטער רעזאָלוציע וואָס דער מאָדעל שטיצט, מיט אַן דערנענטערטן מאַקסימום פֿון 2048 × 2048 פּיקסעלן.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט50
1 – 50
צאָל דענויזינג־טריט וואָס זאָלן דורכגעפֿירט ווערן.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט5
0 – 20
סקאַלע פֿאַר classifier-free guidance; סטאַנדאַרט איז 5.0 פֿאַרן פולן מאָדעל.
seedאָפּציאָנעל
טיפּinteger | null
צופֿעליקער סיד וואָס מאכט די גענערירונג רעפּראָדוצירבאַר.
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 4
צאָל בילדער צו שאַפֿן.
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטpng
jpegpngwebp
פֿײַל־פֿאָרמאַט פון דעם רעזולטירנדיקן בילד.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי גענערירטע בילדער ווערן דורכגעקוקט פֿאַר זיכערקייט.
keep_original_aspectאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
אָפּהיטן אַספּעקט־פֿאַרהעלטעניש בײַ גענערירונג מיט איין רעפֿערענץ: דער רעזולטאַט פּאַסט זיך צו יענעם רעפֿערענץס פּראָפּאָרציעס נאָר ווען גענוי איין בילד איז צוגעשטעלט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hidream-o1-image/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": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_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
      }
    ],
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string",
    "timings": {}
  },
  "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}בילדער געשאַפֿן דורך גענערירונג.
seed
integerסיד־ווערט וואָס ווערט געווענדט בעת גענערירונג.
has_nsfw_concepts
array of booleanסטאַטוס פֿון דעם זיכערקייט־טשעקער פֿאַר יעדן גענערירטן בילד.
prompt
stringפּראָמפּט וואָס איז געניצט געוואָרן צו גענערירן דעם רעזולטאַט.
timings
objectצײַט־מעסטן פֿאַר גענערירונג.

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

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