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

Image Editing Scene Composition

אינטעגרירן

מאָדעל־id image-editing/scene-composition
# 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/image-editing/scene-composition?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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 שליסל
Utility · בילד

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

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

בויען אַ בעטן

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

סטאַנדאַרט enchanted forest

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

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

בילד גענוצט צו פּראָמפּטן דעם omni־מאָדעל.

aspect_ratio

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

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

זיכערהייט־באַשטעטיקונג פֿאַר גענערירטע בילדער: קלײַב 6 פֿאַר די מערסט ליבעראַלע פֿילטערונג אָדער 1 פֿאַר די שטרענגסטע.

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

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

סטאַנדאַרט 3.5

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

סטאַנדאַרט 30

צאָל inference־טריט בעת sampling.

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

POST /run/image-editing/scene-composition?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/image-editing/scene-composition?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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 שליסל

וועגן Image Editing Scene Composition

שטעלט די טעמע פֿון `image_url` אין אַ סביבה וואָס איר באַשרײַבט אין `prompt`; דער סטאַנדאַרט איז "enchanted forest". ליכטונג און קאָמפּאָזיציע ווערן צוגעפּאַסט צו דער נײַער סצענע. ווײַטערדיקע אַרײַנגעבונגען אַרייַננעמען `guidance_scale`, `num_inference_steps` (1 ביז 50), jpeg אָדער png־רעזולטאַט, `aspect_ratio` און `seed`.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
בילד גענוצט צו פּראָמפּטן דעם omni־מאָדעל.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט3.5
0 – 20
שטאַרקייט פֿון פּראָמפּט־אנהאַלטונג פֿאַר בילד־אויסקלײַב, אויסגעדריקט ווי CFG (Classifier Free Guidance).
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט30
1 – 50
צאָל inference־טריט בעת sampling.
safety_toleranceאָפּציאָנעל
טיפּenum
סטאַנדאַרט2
123456
זיכערהייט־באַשטעטיקונג פֿאַר גענערירטע בילדער: קלײַב 6 פֿאַר די מערסט ליבעראַלע פֿילטערונג אָדער 1 פֿאַר די שטרענגסטע.
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטjpeg
jpegpng
פֿײַל־פֿאָרמאַט פון דעם רעזולטירנדיקן בילד.
aspect_ratioאָפּציאָנעל
טיפּenum
21:916:94:33:21:12:33:49:169:21
אַספּעקט־פֿאַרהעלטעניש פֿאַר דעם רעזולטירנדיקן בילד.
seedאָפּציאָנעל
טיפּinteger | null
סיד פֿאַר רעפּראָדוצירבאַרע בילדער: אַן אידענטישער פּראָמפּט און סיד שאַפֿן אַן אידענטיש בילד ווען די מאָדעל־ווערסיע איז אומגעענדערט.
promptאָפּציאָנעל
טיפּstring
סטאַנדאַרטenchanted forest
באַשרײַבונג פֿון דער סצענע אין וועלכער מען זאָל שטעלן דעם סוביעקט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "image-editing/scene-composition",
  "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": {
    "image_url": "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
  },
  "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

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

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