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

SDXL ControlNet Union · Image to Image

אינטעגרירן

מאָדעל־id sdxl-controlnet-union/image-to-image
# 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/sdxl-controlnet-union/image-to-image?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",
    "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.048⁩ 48 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Stability AI בילד־עדיטירונג #diffusion#controlnet#composition

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

Stability AI · בילד

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

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

בויען אַ בעטן

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

•פארלאנגט

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

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

אָנהייב־בילד פֿאַר גענערירונג, געגעבן דורך URL.

image_size

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

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

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

פֿאָרגעשריטן negative_prompt · openpose_image_url · depth_image_url · teed_image_url · canny_image_url · normal_image_url · segmentation_image_url · safety_checker_version · format · request_id · controlnet_conditioning_scale · num_inference_steps · guidance_scale · strength · seed · enable_safety_checker · expand_prompt · preserve_aspect_ratio · crop_output · openpose_preprocess · depth_preprocess · teed_preprocess · canny_preprocess · normal_preprocess · segmentation_preprocess · loras · embeddings
סטאַנדאַרט

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

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

URL צו דעם קאָנטראָל־בילד.

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

URL צו דעם קאָנטראָל־בילד.

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

URL צו דעם קאָנטראָל־בילד.

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

URL צו דעם קאָנטראָל־בילד.

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

URL צו דעם קאָנטראָל־בילד.

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

URL צו דעם קאָנטראָל־בילד.

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

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

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

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

סטאַנדאַרט

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

סטאַנדאַרט 0.5

שטאַרקייט פֿון דער קאָנדיציאָנירונג וואָס ControlNet אָנווענדט.

סטאַנדאַרט 35

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

סטאַנדאַרט 7.5

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

סטאַנדאַרט 0.95

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

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

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

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

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

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

POST /run/sdxl-controlnet-union/image-to-image?wait=20 פּרײַז → ⁨$ 0.048⁩
# 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/sdxl-controlnet-union/image-to-image?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",
    "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 שליסל

וועגן SDXL ControlNet Union · Image to Image

טראַנספֿאָרמירט אַן אָנהייב־בילד מיט אַן SDXL באַזע, געפירט דורך אַ פּראָמפּט און אָפּציאָנעלע קאָנטראָל־בילדער פֿאַר openpose, טיפֿקייט־מאַפּע, teed, canny, normal און סעגמענטאַציע. יעדער קאָנטראָל־אַרײַנגעבונג האָט זײַן אייגענעם preprocess־שאַלטער. `strength` גייט 0.05 ביז 1, `num_inference_steps` 1 ביז 70, און ביז 8 בילדער קענען ווערן צוריקגעגעבן פּער רוף. LoRAs און עמבעדינגס קענען ווערן צוגעשטעלט, און דער רעזולטאַט איז jpeg אָדער png.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
באַשרײַבט דאָס בילד וואָס איר ווילט גענערירן; ניצט ווי פֿיל דעטאַל ווי מעגלעך פֿאַר די בעסטע רעזולטאַטן.
controlnet_conditioning_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.5
0 – 1
שטאַרקייט פֿון דער קאָנדיציאָנירונג וואָס ControlNet אָנווענדט.
image_urlפארלאנגט image
טיפּurl · image
אָנהייב־בילד פֿאַר גענערירונג, געגעבן דורך URL.
negative_promptאָפּציאָנעל
טיפּstring
סטאַנדאַרט
נעגאַטיווער פּראָמפּט וואָס ספּעציפֿיצירט אומגעוווּנטשן בילד־דעטאַל. ער קען אויסשליסן קאָלירן, אָביעקטן, לאַנדשאַפֿט אָדער קלענערע פֿעיִקייטן און קוואַליטעטן, ווי וואָנצעס, בלער אָדער נידעריקע רעזאָלוציע.
image_sizeאָפּציאָנעל
טיפּobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
רעזולטאַט־דימענסיעס, אויטאָמאַטיש באַשטימט פֿון קאָנטראָל־בילד ווען מען גיט נישט קיין גרייס.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט35
1 – 70
צאָל אינפֿערענץ־סטעפּס צו לויפֿן.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט7.5
0 – 20
שטאַרקייט פֿון פּראָמפּט־אנהאַלטונג פֿאַר בילד־אויסקלײַב, אויסגעדריקט ווי CFG (Classifier Free Guidance).
strengthאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.95
0.05 – 1
גראַד פֿון ענלעכקייט צווישן דעם גענערירטן בילד און דעם ערשטיקן בילד.
seedאָפּציאָנעל
טיפּinteger | null
זוימען פֿאַר רעפּראָדוצירן בילדער אין Stable Diffusion. אַ בילד קען ווערן פּונקט רעפּראָדוצירט ביי יעדן לויפֿן דורך לאָזן מאָדעל־ווערסיע, פּראָמפּט און זוימען אומגעענדערט.
num_imagesאָפּציאָנעל num_outputs
טיפּinteger
סטאַנדאַרט1
1 – 8
געבעטן צאָל בילדער פֿאַר גענערירונג.
lorasאָפּציאָנעל
טיפּobject[]
סטאַנדאַרט[]
LoRA־ווייכטן אויסגעקליבן פֿאַר באַניץ, צוגעשטעלט ווי אַ ליסטע.
loras[].forceאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
צי באַניץ פֿון עמבעדינגס איז מאַנדאַטאָריש: true מאַכט עס פֿאַרמאָגלעך.
loras[].pathפארלאנגט
טיפּstring
LoRA־ווייכטן־קוואַל, צוגעשטעלט ווי אַ HF מאָדעל־אידענטיפֿיקאַטאָר וואָס רעזאָלוות צו safetensors־ווייכטן, אָדער ווי אַ safetensors פֿײַל געפֿונען דורך URL אָדער דרך.
loras[].scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט1
0 – 1
מולטיפּליקאַטאָר אָנגעווענדט אויף דער LoRA־וואָג איידער זי ווערט צונויפֿגעמישט מיטן באַזע־מאָדעל.
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
סטאַנדאַרט
אידענטיפֿיקאַטאָר פֿון דער בקשה פֿאַר פֿאַרבינדן אַ רעאַקציע מיט דער בקשה וואָס האָט זי געשאַפֿן.
preserve_aspect_ratioאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
שטעלט צו true צו אויפֿהיטן דעם אַספּעקט־פֿאַרהעלטעניש פֿון דעם גענערירטן בילד, אַפֿילו ווען זײַן גרייס איבערגייט דעם לימיט. כּדי צו באַקומען די ריכטיקע פּראָפּאָרציעס דורך אָפּשנײַדן נאָך דער גענערירונג, שטעלט crop_output צו True. ברייט־ אָדער הייך־ווערטע וואָס זענען נישט צעטיילבאַר מיט 32 ווערן נאָך אַלץ געראַונדעט צו דעם נאָענסטן קייפּל פֿון 32, און די גרייס־ענדערונג היט נישט דעם אַספּעקט־פֿאַרהעלטעניש בײַם סטאַנדאַרט.
crop_outputאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
אָפּשנײַדן דעם גענערירטן רעזולטאַט צו דעם ריכטיקן אַספּעקט־פֿאַרהעלטעניש ווען true.
openpose_image_urlאָפּציאָנעל
טיפּurl · image
URL צו דעם קאָנטראָל־בילד.
openpose_preprocessאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
רעגולירט די פֿאָרבאַאַרבעטונג פֿונעם openpose־בילד.
depth_image_urlאָפּציאָנעל
טיפּurl · image
URL צו דעם קאָנטראָל־בילד.
depth_preprocessאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
רעגולירט די פֿאָרבאַאַרבעטונג פֿונעם טיפֿקייט־בילד.
teed_image_urlאָפּציאָנעל
טיפּurl · image
URL צו דעם קאָנטראָל־בילד.
teed_preprocessאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
רעגולירט די פֿאָרבאַאַרבעטונג פֿונעם teed־בילד.
canny_image_urlאָפּציאָנעל
טיפּurl · image
URL צו דעם קאָנטראָל־בילד.
canny_preprocessאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
רעגולירט די פֿאָרבאַאַרבעטונג פֿונעם canny־בילד.
normal_image_urlאָפּציאָנעל
טיפּurl · image
URL צו דעם קאָנטראָל־בילד.
normal_preprocessאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
רעגולירט די פֿאָרבאַאַרבעטונג פֿונעם נאָרמאַלן־בילד.
segmentation_image_urlאָפּציאָנעל
טיפּurl · image
URL צו דעם קאָנטראָל־בילד.
segmentation_preprocessאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
רעגולירט די פֿאָרבאַאַרבעטונג פֿונעם סעגמענטאַציע־בילד.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sdxl-controlnet-union/image-to-image",
  "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": 48,
    "usd": "0.048",
    "charged": 48,
    "refunded": 0
  },
  "input": {
    "image_url": "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",
        "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/sdxl-controlnet-union/image-to-image.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt