رفتن به محتوا

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"

این درخواست: ≈⁨‎$۰٫۰۱۴⁩ ۱۴ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Stability AI متن به تصویر #diffusion#controlnet#composition

SDXL متن‌به‌تصویر با هدایت حداکثر شش تصویر کنترلی: openpose، نقشهٔ عمق، teed، canny، normal، قطعه‌بندی

Stability AI · تصویر

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی

تصویری را که می‌خواهید تولید شود با بیشترین جزئیات ممکن توصیف کنید تا بهترین نتیجه به‌دست آید.

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).

seed برای بازتولید تصاویر در Stable Diffusion. با ثابت نگه‌داشتن نسخه مدل، پرامپت و seed، تصویر می‌تواند در هر اجرا دقیقاً بازتولید شود.

پیش‌فرض []

وزن‌های LoRA انتخاب‌شده برای استفاده، به‌صورت فهرست.

پیش‌فرض []

embeddingهای انتخاب‌شده برای استفاده، به‌صورت فهرست.

POST /run/sdxl-controlnet-union?wait=20 قیمت → ⁨‎$۰٫۰۱۴⁩
# 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 است. اندازهٔ تصویر می‌تواند از تصویر کنترلی استنتاج شود. از LoRAها، امبدینگ‌ها، 1 تا 8 تصویر و خروجی jpeg یا png پشتیبانی می‌کند.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
تصویری را که می‌خواهید تولید شود با بیشترین جزئیات ممکن توصیف کنید تا بهترین نتیجه به‌دست آید.
controlnet_conditioning_scaleاختیاری
نوعnumber
پیش‌فرض0.5
۰ – ۱
شدت شرط‌گذاری اعمال‌شده توسط ControlNet.
negative_promptاختیاری
نوعstring
پیش‌فرض
پرامپت منفی برای مشخص‌کردن جزئیات تصویری که باید حذف شوند، از جمله رنگ‌ها، اشیا، مناظر یا ویژگی‌های ظریف‌تر. نمونه‌ها شامل سبیل، تاری یا وضوح پایین هستند.
image_sizeاختیاری
نوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ابعاد خروجی که در صورت ارائه‌نشدن اندازه، به‌طور خودکار از تصویر کنترل تعیین می‌شود.
num_inference_stepsاختیاری
نوعinteger
پیش‌فرض35
۱ – ۷۰
تعداد مراحل استنتاج.
seedاختیاری
نوعinteger | null
seed برای بازتولید تصاویر در Stable Diffusion. با ثابت نگه‌داشتن نسخه مدل، پرامپت و seed، تصویر می‌تواند در هر اجرا دقیقاً بازتولید شود.
guidance_scaleاختیاری
نوعnumber
پیش‌فرض7.5
۰ – ۲۰
میزان پایبندی به پرامپت برای انتخاب تصویر، بیان‌شده به‌صورت CFG (Classifier Free Guidance).
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۸
تعداد تصاویر درخواستی برای تولید.
lorasاختیاری
نوعobject[]
پیش‌فرض[]
وزن‌های LoRA انتخاب‌شده برای استفاده، به‌صورت فهرست.
loras[].forceاختیاری
نوعboolean
پیش‌فرضfalse
الزامی بودن استفاده از embedding؛ مقدار true آن را اجباری می‌کند.
loras[].pathالزامی
نوعstring
منبع وزن LoRA، به‌صورت شناسه مدل HF که به وزن‌های safetensors resolve می‌شود، یا فایل safetensors قابل دسترسی از طریق URL یا مسیر.
loras[].scaleاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
ضریبی که پیش از ادغام LoRA در مدل پایه، روی وزن LoRA اعمال می‌شود.
embeddingsاختیاری
نوعobject[]
پیش‌فرض[]
embeddingهای انتخاب‌شده برای استفاده، به‌صورت فهرست.
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
پیش‌فرض
شناسه درخواست برای مرتبط‌کردن پاسخ با درخواستی که آن را ایجاد کرده است.
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
پیش‌پردازش تصویر normal را کنترل می‌کند.
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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?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پرامپت استفاده‌شده هنگام تولید تصویر.

مدل‌های بیشتر: متن به تصویر

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/sdxl-controlnet-union.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt