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

Uno

אינטעגרירן

מאָדעל־id uno
# 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/uno?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "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.05⁩ 50 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
ByteDance בילד־עדיטירונג #image-to-image

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

ByteDance · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

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

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

URL־ס פֿון בילדער גענוצט בעת בילד־גענערירונג.

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

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

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

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

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

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

סטאַנדאַרט 28

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

סטאַנדאַרט 3.5

שטאַרקייט פֿון פּראָמפּט־אנהאַלטונג פֿאַר בילד־אויסקלײַב, אויסגעדריקט ווי CFG (Classifier Free Guidance).

גענערירונג־Seed: none קלײַבט איינעם צופֿעליק, בשעת אַ צוגעשטעלטער ווערט דערמעגלעכט רעפּראָדוצירבאַרע גענערירונג.

POST /run/uno?wait=20 פּרײַז → ⁨$ 0.05⁩
# 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/uno?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "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 שליסל

וועגן Uno

שאַפֿט נײַע בילדער פֿון אַ פּראָמפּט פּלוס איינס אָדער מער רעפֿערענץ־בילדער אין `input_image_urls`. `image_size` נעמט פּריסעטן פֿון קוואַדראַט ביז 16:9 פּאָרטרעט און לאַנדשאַפֿט, און `num_images` שאַפֿט 1 ביז 4 רעזולטאַטן. `num_inference_steps` ליגט צווישן 1 און 50 און `guidance_scale` צווישן 1 און 20. דער רעזולטאַט איז JPEG אָדער PNG, מיט אַ זוימען פֿאַר רעפּראָדוצירבאַרקייט.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
input_image_urlsפארלאנגט
טיפּurl[] · image
URL־ס פֿון בילדער גענוצט בעת בילד־גענערירונג.
image_sizeאָפּציאָנעל
טיפּobject
סטאַנדאַרטsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
דימענסיעס פונעם רעזולטאַט־בילד, אויסגעקליבן פֿון פּרעסעטן אָדער באַשטימט ווי אייגענע ברייט און הייך. ביידע אייגענע דימענסיעס מוזן זיך צעטיילן מיט 8.
promptפארלאנגט
טיפּstring
פּראָמפּט וואָס פירט בילד־גענערירונג.
seedאָפּציאָנעל
טיפּinteger | null
גענערירונג־Seed: none קלײַבט איינעם צופֿעליק, בשעת אַ צוגעשטעלטער ווערט דערמעגלעכט רעפּראָדוצירבאַרע גענערירונג.
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 4
געבעטן צאָל בילדער פֿאַר גענערירונג.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט28
1 – 50
צאָל אינפֿערענץ־סטעפּס צו לויפֿן.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט3.5
1 – 20
שטאַרקייט פֿון פּראָמפּט־אנהאַלטונג פֿאַר בילד־אויסקלײַב, אויסגעדריקט ווי CFG (Classifier Free Guidance).
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטjpeg
jpegpng
פֿײַל־פֿאָרמאַט פון דעם רעזולטירנדיקן בילד.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
זיכערקייט־קאָנטראָל־שאַלטער, וועמענס אויסגעלאָשענע באַשטעטיקונג דאַרף חשבון־אויטאָריזאַציע. אָן דער אויטאָריזאַציע ווערט יעדער בקשה אָפּגעקוקט אומאָפּהענגיק פֿון דער באַשטעטיקונג; true אַקטיוויזירט דעם קאָנטראָלער.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "uno",
  "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": 50,
    "usd": "0.05",
    "charged": 50,
    "refunded": 0
  },
  "input": {
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "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
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "The figurine is in the crystal ball"
  },
  "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}URL־ס פֿון גענערירטע בילדער.
timings
object
seed
integerבילד־גענערירונג־סיד, אַרײַנגערעכנט דעם ראַנדאָם אויסגעקליבענעם ווערט אויב די אַרײַנגעבונג האט נישט אַרײַנגעגעבן קיין סיד; אַנדערש איבערחזרט עס דעם צוגעשטעלטן ווערט.
has_nsfw_concepts
array of booleanווײַזט צי NSFW־קאָנסעפּטן דערשײַנען אין די גענערירטע בילדער.
prompt
stringפּראָמפּט צוגעשטעלט פֿאַר בילד־גענערירונג.

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