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

Playground v2.5

אינטעגרירן

מאָדעל־id playground-v25
# 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/playground-v25?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.013⁩ 13 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Playground טעקסט צו בילד #artistic#style

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

Playground · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

באַשרײַבט דאָס בילד וואָס איר ווילט גענערירן; ניצט ווי פֿיל דעטאַל ווי מעגלעך פֿאַר די בעסטע רעזולטאַטן.

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

דימענסיעס פֿונעם גענערירטן בילד.

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

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

פֿאָרגעשריטן negative_prompt · safety_checker_version · format · request_id · num_inference_steps · guidance_scale · seed · enable_safety_checker · expand_prompt · embeddings
סטאַנדאַרט

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

safety_checker_version סטאַנדאַרט v1

קלײַבט צווישן אַ קאַסטאַם ViT זיכערקייט־קאָנטראָלירער (`v2`) און דעם CompVis־קאָנטראָלירער (`v1`, דער סטאַנדאַרט).

format סטאַנדאַרט jpeg

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

סטאַנדאַרט

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

סטאַנדאַרט 25

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

סטאַנדאַרט 3

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

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

סטאַנדאַרט []

עמבעדינגס אויסגעקליבן פֿאַר באַניץ, צוגעשטעלט ווי אַ ליסטע.

POST /run/playground-v25?wait=20 פּרײַז → ⁨$ 0.013⁩
# 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/playground-v25?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 שליסל

וועגן Playground v2.5

שאַפֿט בילדער פֿון אַ נייטיקן `prompt` מיט זעקס פּרעסעט־`image_size`־ווערטס פֿון square_hd ביז landscape_16_9. `num_inference_steps` גייט פֿון 1 ביז 50 און `guidance_scale` פֿון 0 ביז 20. מע קען צוריקגעבן ביז 8 בילדער פּער רוף, אין jpeg אָדער png. עס נעמט אויך אָן אַ `negative_prompt`, אַ רשימה פֿון `embeddings`, אַ `seed` און אַן אָפּציאָנאַלע פּrompt־יקספּאַנשאַן.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
באַשרײַבט דאָס בילד וואָס איר ווילט גענערירן; ניצט ווי פֿיל דעטאַל ווי מעגלעך פֿאַר די בעסטע רעזולטאַטן.
negative_promptאָפּציאָנעל
טיפּstring
סטאַנדאַרט
נעגאַטיווער פּראָמפּט וואָס ספּעציפֿיצירט בילד־דעטאַלן צו אויסשליסן, אַרײַנגערעכנט קאָלירן, אָביעקטן, לאַנדשאַפֿט אָדער קלענערע פֿעיִקייטן. בײַשפּילן: וואָנצעס, בלער אָדער נידעריקע רעזאָלוציע.
image_sizeאָפּציאָנעל
טיפּobject
סטאַנדאַרטsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
דימענסיעס פֿונעם גענערירטן בילד.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט25
1 – 50
צאָל אינפֿערענץ־סטעפּס צו לויפֿן.
seedאָפּציאָנעל
טיפּinteger | null
זוימען פֿאַר רעפּראָדוצירן בילדער אין Stable Diffusion. אַ בילד קען ווערן פּונקט רעפּראָדוצירט ביי יעדן לויפֿן דורך לאָזן מאָדעל־ווערסיע, פּראָמפּט און זוימען אומגעענדערט.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט3
0 – 20
שטאַרקייט פֿון פּראָמפּט־אנהאַלטונג פֿאַר בילד־אויסקלײַב, אויסגעדריקט ווי CFG (Classifier Free Guidance).
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 8
געבעטן צאָל בילדער פֿאַר גענערירונג.
embeddingsאָפּציאָנעל
טיפּobject[]
סטאַנדאַרט[]
עמבעדינגס אויסגעקליבן פֿאַר באַניץ, צוגעשטעלט ווי אַ ליסטע.
embeddings[].pathפארלאנגט
טיפּstring
עמבעדינג־ווייכטן ספּעציפֿיצירט דורך URL אָדער פֿײַל־דרך.
embeddings[].tokensאָפּציאָנעל
טיפּstring[]
עמבעדינג־טאָקען־ליסטע, מיט אָטאָמאַטישער נאָמענקלאַטור ווען נישט צוגעשטעלט: יעדער וועקטאָר אין דער עמבעדינג־פֿײַל באַקומט אַ טאָקען פֿון דער סעקוואַנץ <s0>, <s1>, ... .
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אַקטיוואַציע פון זיכערקייט־קאָנטראָלער; true דערמעגלעכט קאָנטראָל.
safety_checker_versionאָפּציאָנעל
טיפּenum
סטאַנדאַרטv1
v1v2
קלײַבט צווישן אַ קאַסטאַם ViT זיכערקייט־קאָנטראָלירער (`v2`) און דעם CompVis־קאָנטראָלירער (`v1`, דער סטאַנדאַרט).
expand_promptאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
פּראָמפּט־יקספּאַנשאַן מיט נאָך פּראָמפּטן, אַקטיווירט ווען true.
formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטjpeg
jpegpng
פֿײַל־פֿאָרמאַט פון דעם רעזולטירנדיקן בילד.
request_idאָפּציאָנעל
טיפּstring
סטאַנדאַרט
אידענטיפֿיקאַטאָר פֿון דער בקשה פֿאַר פֿאַרבינדן אַ רעאַקציע מיט דער בקשה וואָס האָט זי געשאַפֿן.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "playground-v25",
  "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": 13,
    "usd": "0.013",
    "charged": 13,
    "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",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "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, width, height, content_type}פֿײַל־אינפֿאָרמאַציע פֿאַר די גענערירטע בילדער.
timings
object
seed
integerבילד־גענערירונג־סיד, אַרײַנגערעכנט דעם ראַנדאָם אויסגעקליבענעם ווערט אויב די אַרײַנגעבונג האט נישט אַרײַנגעגעבן קיין סיד; אַנדערש איבערחזרט עס דעם צוגעשטעלטן ווערט.
has_nsfw_concepts
array of booleanווײַזט צי NSFW־קאָנסעפּטן דערשײַנען אין די גענערירטע בילדער.
prompt
stringפּראָמפּט וואָס ווערט גענוצט בעת בילד־גענערירונג.

מער מאָדעלן: טעקסט צו בילד

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