דילוג לתוכן

Z Image Turbo Controlnet

שילוב

מזהה מודל z-image/turbo/controlnet
# 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/z-image/turbo/controlnet?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.013 ‏$⁩ 13 קרדיטי API הרצה בדף הזה

קבלת מפתח API
Alibaba · תמונה

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה

הנחיה המנחה את יצירת התמונה.

•חובה image_url
גרור קובץ, או

כתובת URL של תמונה המשמשת כקלט ליצירת ControlNet.

image_size ברירת מחדל auto

ממדי התמונה שנוצרה.

num_images ברירת מחדל 1

מספר התמונות המבוקש ליצירה.

מתקדם output_format · acceleration · preprocess · num_inference_steps · control_scale · control_start · control_end · seed · enable_safety_checker · enable_prompt_expansion
output_format ברירת מחדל png

פורמט הקובץ של התמונה שהתקבלה.

acceleration ברירת מחדל regular

רמת ההאצה שהוחלה על העיבוד.

preprocess ברירת מחדל none

שיטת עיבוד מקדים המוחלת על התמונה, או ללא עיבוד מקדים.

ברירת מחדל 8

מספר שלבי ההסקה לביצוע.

ברירת מחדל 0.75

עוצמת ההתניה המוחלת על ידי ControlNet.

ברירת מחדל 0

נקודת ההתחלה להתניה של ControlNet.

ברירת מחדל 0.8

נקודת הסיום להתניה של ControlNet.

seed לתמונות ניתנות לשחזור: הנחיה ו־seed זהים מפיקים תמונה זהה כאשר גרסת המודל לא השתנתה.

POST /run/z-image/turbo/controlnet?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/z-image/turbo/controlnet?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"

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

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

מידע על Z Image Turbo Controlnet

מפיק תמונה מ-`prompt` כאשר תמונת בקרה (`image_url`) מכוונת את המבנה. `preprocess` יכול לחלץ קצוות canny, עומק או תנוחה, או להשתמש ב-none. `control_scale`, `control_start` ו-`control_end` מכווננים את עוצמת ההתניה ואת מועד החלתה. תומך בעד 4 תמונות, 8 צעדים וב-`image_size` אוטומטי.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
הנחיה המנחה את יצירת התמונה.
image_sizeאופציונלי
סוגobject
ברירת מחדלauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
ממדי התמונה שנוצרה.
num_inference_stepsאופציונלי
סוגinteger
ברירת מחדל8
1 – 8
מספר שלבי ההסקה לביצוע.
seedאופציונלי
סוגinteger | null
seed לתמונות ניתנות לשחזור: הנחיה ו־seed זהים מפיקים תמונה זהה כאשר גרסת המודל לא השתנתה.
num_imagesאופציונלי num_outputs
סוגinteger
ברירת מחדל1
1 – 4
מספר התמונות המבוקש ליצירה.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
בדיקת בטיחות, שמחזירה תמונות שחורות במקום תמונות שסומנו כלא בטוחות. ערך true מאפשר את הבדיקה; false משבית אותה רק עבור חשבונות מורשים, בעוד שבקשות ללא הרשאה נבדקות בכל מקרה.
output_formatאופציונלי
סוגenum
ברירת מחדלpng
jpegpngwebp
פורמט הקובץ של התמונה שהתקבלה.
accelerationאופציונלי
סוגenum
ברירת מחדלregular
noneregularhigh
רמת ההאצה שהוחלה על העיבוד.
enable_prompt_expansionאופציונלי
סוגboolean
ברירת מחדלfalse
שולט אם הרחבת ההנחיה מופעלת.
image_urlחובה image
סוגurl · image
כתובת URL של תמונה המשמשת כקלט ליצירת ControlNet.
control_scaleאופציונלי
סוגnumber
ברירת מחדל0.75
0 – 1
עוצמת ההתניה המוחלת על ידי ControlNet.
control_startאופציונלי
סוגnumber
ברירת מחדל0
0 – 1
נקודת ההתחלה להתניה של ControlNet.
control_endאופציונלי
סוגnumber
ברירת מחדל0.8
0 – 1
נקודת הסיום להתניה של ControlNet.
preprocessאופציונלי
סוגenum
ברירת מחדלnone
nonecannydepthpose
שיטת עיבוד מקדים המוחלת על התמונה, או ללא עיבוד מקדים.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "z-image/turbo/controlnet",
  "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",
    "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
      }
    ],
    "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, content_type, file_name, file_size, width, height}פרטי קובץ עבור התמונות שנוצרו.
timings
objectפרטי תזמון תהליך היצירה.
seed
integerSeed ליצירת תמונה, כולל הערך שנבחר באקראי אם הקלט לא כלל Seed; אחרת, הוא חוזר על הערך שסופק.
has_nsfw_concepts
array of booleanמציין אם מושגים מסוג NSFW מופיעים בתמונות שנוצרו.
prompt
stringהנחיה המשמשת במהלך יצירת התמונה.

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

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