דילוג לתוכן

SDXL ControlNet Union · Image to Image

שילוב

מזהה מודל 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

בקשה זו: ≈⁨‏0.048 ‏$⁩ 48 קרדיטי API · ≈ ⁨‏5.16 ‏₽⁩ הרצה בדף הזה

קבלת מפתח 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 שנבחרו לשימוש, מסופקים כרשימה.

ברירת מחדל []

Embeddings שנבחרו לשימוש, מסופקים כרשימה.

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על SDXL ControlNet Union · Image to Image

משנה תמונת התחלה באמצעות בסיס SDXL המונחה על ידי הנחיה ותמונות בקרה אופציונליות עבור openpose, מפת עומק, teed, canny, normal וסגמנטציה. לכל קלט בקרה יש מתג עיבוד מקדים משלו. `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
האם השימוש ב-embedding חובה: true הופך אותו לחובה.
loras[].pathחובה
סוגstring
מקור משקלי LoRA, המסופק כמזהה מודל HF שנפתר למשקלי safetensors או כקובץ safetensors הממוקם באמצעות כתובת URL או נתיב.
loras[].scaleאופציונלי
סוגnumber
ברירת מחדל1
0 – 1
מכפיל המוחל על משקל ה־LoRA לפני מיזוגו במודל הבסיס.
embeddingsאופציונלי
סוגobject[]
ברירת מחדל[]
Embeddings שנבחרו לשימוש, מסופקים כרשימה.
embeddings[].pathחובה
סוגstring
משקלי embedding שצוינו באמצעות כתובת URL או נתיב קובץ.
embeddings[].tokensאופציונלי
סוגstring[]
רשימת טוקנים של embedding, עם מתן שמות אוטומטי כאשר הרשימה מושמטת: כל וקטור בקובץ ה-embedding מקבל טוקן מהרצף <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
שולט בעיבוד המקדים של תמונת הפילוח.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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
integerSeed ליצירת תמונה, כולל הערך שנבחר באקראי אם הקלט לא כלל Seed; אחרת, הוא חוזר על הערך שסופק.
has_nsfw_concepts
array of booleanמציין אם מושגים מסוג NSFW מופיעים בתמונות שנוצרו.
prompt
stringהנחיה המשמשת במהלך יצירת התמונה.

מודלים נוספים: עריכת תמונה

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/sdxl-controlnet-union/image-to-image.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt