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

Hidream O1 Image · Dev · Edit

אינטעגרירן

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

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

דיסטילירטער dev וואַריאַנט פֿאַר רעפֿערענץ־בילד־עדיטירונג, 28 טריט און guidance 0 לויטן באַשטעטיקטן ווערט

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

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

סטאַנדאַרט 28

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

סטאַנדאַרט 0

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

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

POST /run/hidream-o1-image/dev/edit?wait=20 פּרײַז → ⁨$ 0.02⁩
# 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/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 · Dev · Edit

עדיטירט אָדער פּערסאָנאַליזירט בילדער פֿון רעפֿערענץ־בילדער (`reference_image_urls`) און אַ טעקסט־`prompt`, מיטן דיסטילירטן dev מאָדעל פֿײַנגעשטעלט פֿאַר 28 שריט און אַ גיידאַנס־סקאַלע וואָס איז סטאַנדאַרט 0. דער רעזולטאַט גייט ביז בערך 2048x2048 דורך גרייס־פּריסעטן אָדער אייגענע דימענסיעס. גיט צוריק 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
סטאַנדאַרט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/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": 20,
    "usd": "0.02",
    "charged": 20,
    "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/dev/edit.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt