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

Hidream O1 Image · Dev

אינטעגרירן

מאָדעל־id hidream-o1-image/dev
# 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/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"
  }'

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

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

דיסטילירטער 28־שריט HiDream טעקסט־צו־בילד וואַריאַנט מיט גיידאַנס אויסגעלאָשן סטאַנדאַרט, וואָס נעמט אָפּציאָנעלע רעפֿערענץ־בילדער

HiDream · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

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

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

רעזולטאַט־דימענסיעס מיט אַן דערנענטערטן דאַך פֿון 2048 × 2048 פּיקסעלן; יעדע געבעטע דימענסיע ווערט רעדוצירט צום נענסטן מולטיפּל פֿון 32.

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

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

פֿאָרגעשריטן images · output_format · num_inference_steps · guidance_scale · seed · enable_safety_checker · keep_original_aspect
reference_image_urls סטאַנדאַרט []
לייגט אַרײַן אַ טעקע, אָדער

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

output_format סטאַנדאַרט png

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

סטאַנדאַרט 28

צאָל דענויזינג־איטעראַציעס, וווּ 28 טריט שטימען מיטן דיסטילאַציע־ציל פֿונעם dev מאָדעל.

סטאַנדאַרט 0

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

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

POST /run/hidream-o1-image/dev?wait=20 פּרײַז → ⁨$ 0.005⁩
# 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/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"
  }'

# 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 · Dev

דער dev ווערסיע פֿונעם מאָדעל איז דיסטילירט פֿאַר 28 טריט, דערפֿאַר דערגרייכט `num_inference_steps` מאַקסימום 28 און `guidance_scale` איז 0 לויטן באַשטעטיקטן ווערט. זי נעמט ווײַטער אַ `prompt` און אָפּציאָנעלע `reference_image_urls` פֿאַר עדיטירונג אָדער פּערסאָנאַליזאַציע. די רעזולטאַט־גרייס גייט ביז בערך 2048x2048, מיט 1 ביז 4 בילדער פּער רוף אין png, jpeg אָדער webp.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
טעקסט־אינסטרוקציעס פֿאַר שאַפֿן אָדער רעדאַקטירן בילדער, אָדער פֿאַר סוביעקט־געטריבענער פּערסאָנאַליזאַציע.
reference_image_urlsאָפּציאָנעל images
טיפּurl[] · image
סטאַנדאַרט[]
רעפֿערענץ־בילדער פֿאַר רעדאַקטירונג (איין בילד) אָדער סוביעקט־געטריבענער פּערסאָנאַליזאַציע (מערערע בילדער); לאָזט זיי אויס בײַ טעקסט־צו־בילד־גענערירונג.
image_sizeאָפּציאָנעל
טיפּobject
סטאַנדאַרט{"height":1024,"width":1024}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
רעזולטאַט־דימענסיעס מיט אַן דערנענטערטן דאַך פֿון 2048 × 2048 פּיקסעלן; יעדע געבעטע דימענסיע ווערט רעדוצירט צום נענסטן מולטיפּל פֿון 32.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט28
1 – 28
צאָל דענויזינג־איטעראַציעס, וווּ 28 טריט שטימען מיטן דיסטילאַציע־ציל פֿונעם dev מאָדעל.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0
0 – 20
סקאַלע פֿאַר classifier-free guidance; סטאַנדאַרט איז 0.0 פֿאַרן dev מאָדעל.
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/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": 5,
    "usd": "0.005",
    "charged": 5,
    "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
      }
    ],
    "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/dev.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt