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

ControlNet SDXL · Image to Image

التكامل

معرّف النموذج fast-sdxl-controlnet-canny/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/fast-sdxl-controlnet-canny/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",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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.015 $⁩ 15 رصيد API · ≈ ⁨‏1.60 ₽⁩ تشغيله في هذه الصفحة

الحصول على مفتاح API
Stability AI تحرير الصور سريع #diffusion#controlnet#editing#manipulation

تحويل صورة إلى صورة باستخدام ControlNet SDXL: إعادة تصميم صورة مصدر وفق بنية صورة تحكم

Stability AI · صورة

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

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

إنشاء طلب

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

•مطلوب

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

•مطلوب
أفلت ملفًا، أو

عنوان URL يشير إلى صورة التحكم.

•مطلوب image_url
أفلت ملفًا، أو

الصورة الابتدائية للتوليد، مقدّمة عبر عنوان URL.

image_size

أبعاد المخرج، تُحدّد تلقائيًا من صورة التحكم عند عدم تقديم حجم.

num_images الافتراضي 1

عدد الصور المطلوب توليده.

متقدم negative_prompt · 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 · loras · embeddings
الافتراضي

موجّه سلبي يحدد تفاصيل الصورة غير المرغوبة. يمكنه استبعاد الألوان والعناصر والمشهد أو السمات والصفات الدقيقة، مثل الشارب أو الضبابية أو الدقة المنخفضة.

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/fast-sdxl-controlnet-canny/image-to-image?wait=20 عرض السعر → ⁨‏0.015 $⁩
# 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/fast-sdxl-controlnet-canny/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",
    "control_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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

حول ControlNet SDXL · Image to Image

يأخذ `prompt` و`control_image_url` للبنية و`image_url` كنقطة بداية. تحدد `strength` (من 0.05 إلى 1، والافتراضي 0.95) مدى اتباع النتيجة للمصدر. تشمل الإضافات `preserve_aspect_ratio` و`crop_output` وLoRA والتضمينات وما يصل إلى 8 صور لكل طلب.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
صِف الصورة التي تريد توليدها بأكبر قدر ممكن من التفصيل للحصول على أفضل النتائج.
control_image_urlمطلوب
النوعurl · image
عنوان URL يشير إلى صورة التحكم.
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.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "fast-sdxl-controlnet-canny/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": 15,
    "usd": "0.015",
    "charged": 15,
    "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",
    "control_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",
        "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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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/fast-sdxl-controlnet-canny/image-to-image.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt