تخطّي إلى المحتوى

SDXL ControlNet Union

التكامل

معرّف النموذج sdxl-controlnet-union
# 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?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.014 $⁩ 14 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Stability AI من نص إلى صورة #diffusion#controlnet#composition

SDXL لتحويل النص إلى صورة، موجّه بما يصل إلى ست صور تحكم: openpose وdepth وteed وcanny وnormal وsegmentation

Stability AI · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب

صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.

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 · seed · enable_safety_checker · expand_prompt · 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).

بذرة لإعادة إنتاج الصور في Stable Diffusion. يمكن إعادة إنتاج الصورة تمامًا في كل تشغيل بالحفاظ على إصدار النموذج والموجّه والبذرة دون تغيير.

الافتراضي []

أوزان LoRA المحددة للاستخدام، والمقدَّمة كقائمة.

الافتراضي []

التضمينات المحددة للاستخدام، والمقدَّمة كقائمة.

POST /run/sdxl-controlnet-union?wait=20 عرض السعر → ⁨‏0.014 $⁩
# 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?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"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول SDXL ControlNet Union

يولّد صور SDXL من `prompt` موجّه بصور تحكم مثل openpose أو خريطة العمق أو teed أو canny أو normal أو التقسيم، ولكل منها مفتاح معالجة مسبقة خاص. يتراوح `controlnet_conditioning_scale` من 0 إلى 1. يمكن استنتاج حجم الصورة من صورة التحكم. يدعم LoRAs والتضمينات و1 إلى 8 صور ومخرج jpeg أو png.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.
controlnet_conditioning_scaleاختياري
النوعnumber
الافتراضي0.5
0 – 1
قوة التهيئة المطبقة بواسطة ControlNet.
negative_promptاختياري
النوعstring
الافتراضي
موجّه سلبي يحدد تفاصيل الصورة المطلوب استبعادها، بما في ذلك الألوان والعناصر والمشهد أو السمات الدقيقة. تشمل الأمثلة الشارب والضبابية والدقة المنخفضة.
image_sizeاختياري
النوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد المخرج، تُحدّد تلقائيًا من صورة التحكم عند عدم تقديم حجم.
num_inference_stepsاختياري
النوعinteger
الافتراضي35
1 – 70
عدد خطوات الاستدلال المطلوب تنفيذها.
seedاختياري
النوعinteger | null
بذرة لإعادة إنتاج الصور في Stable Diffusion. يمكن إعادة إنتاج الصورة تمامًا في كل تشغيل بالحفاظ على إصدار النموذج والموجّه والبذرة دون تغيير.
guidance_scaleاختياري
النوعnumber
الافتراضي7.5
0 – 20
قوة الالتزام بالموجّه لاختيار الصورة، معبَّر عنها بصيغة CFG (Classifier Free Guidance).
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
الافتراضي
معرّف الطلب لربط الاستجابة بالطلب الذي أنشأها.
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",
  "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": 14,
    "usd": "0.014",
    "charged": 14,
    "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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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الموجّه المستخدم أثناء توليد الصورة.

مزيد من النماذج: من نص إلى صورة

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/sdxl-controlnet-union.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt