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

Boogu Image · Edit

التكامل

معرّف النموذج boogu-image/edit
# 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/boogu-image/edit?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.08 $⁩ 80 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model تحرير الصور

تحرير صور قائم على التعليمات من صورة إدخال، مع قوتين منفصلتين لإرشاد النص والصورة

Open model · صورة

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

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

إنشاء طلب

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

•مطلوب

تعليمات تحويل الصورة مكتوبة بإحدى اللغتين المدعومتين في Boogu-Image، الإنجليزية أو الصينية.

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

عنوان URL الذي يشير إلى الصورة التي ستُحرر.

image_size

أبعاد الصورة المحررة، وتكون افتراضياً أبعاداً تحافظ على نسب المدخل وتبقى ضمن حد النموذج الأصلي البالغ 2K.

num_images الافتراضي 1

عدد الصور المحررة المطلوب إنتاجها.

متقدم negative_prompt · output_format · num_inference_steps · guidance_scale · image_guidance_scale · cfg_range_start · cfg_range_end · seed · enable_safety_checker
الافتراضي

المحتوى الذي يجب استبعاده من الصورة المحررة عبر التوجيه الخالي من المصنّف. تؤدي القيمة الفارغة إلى إيقاف توجيه النص السلبي.

output_format الافتراضي jpeg

تنسيق ملف الصورة الناتجة.

الافتراضي 30

عدد تكرارات إزالة التشويش المطلوب تنفيذها.

الافتراضي 4

قوة التوجيه النصي للتحرير: زدها لجعل التعديل أكثر التزاماً بالتعليمات.

الافتراضي 1

قوة توجيه الصورة المرجعية، مع الحفاظ الأقوى على المدخل عند الإعدادات الأعلى، وعدم وجود CFG للصورة عند 1.0.

الافتراضي 0

نقطة البداية، معبراً عنها بكسر زمني، لتطبيق CFG.

الافتراضي 1

نقطة النهاية، معبراً عنها بكسر زمني، لتطبيق CFG.

بذرة لتوليد صور قابلة للتكرار: يمكن إعادة إنتاج الصورة بدقة بإعادة استخدام بذرتها مع الموجّه الأصلي والصورة المدخلة وإصدار النموذج.

POST /run/boogu-image/edit?wait=20 عرض السعر → ⁨‏0.08 $⁩
# 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/boogu-image/edit?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

حول Boogu Image · Edit

يحرّر الصورة في `image_url` وفق `prompt` نصية مكتوبة بالإنجليزية أو الصينية. إذا لم تُحدّد `image_size`، يتبع الإخراج نسبة عرض الإدخال إلى ارتفاعه ضمن الحد الأصلي 2K. تتحكم `guidance_scale` في الالتزام بالمطالبة، بينما تحافظ `image_guidance_scale` (من 1 إلى 8) على قدر أكبر من الإدخال كلما زادت. يعيد من 1 إلى 4 صور محررة بصيغة jpeg أو png.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
تعليمات تحويل الصورة مكتوبة بإحدى اللغتين المدعومتين في Boogu-Image، الإنجليزية أو الصينية.
image_urlمطلوب image
النوعurl · image
عنوان URL الذي يشير إلى الصورة التي ستُحرر.
negative_promptاختياري
النوعstring
الافتراضي
المحتوى الذي يجب استبعاده من الصورة المحررة عبر التوجيه الخالي من المصنّف. تؤدي القيمة الفارغة إلى إيقاف توجيه النص السلبي.
image_sizeاختياري
النوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد الصورة المحررة، وتكون افتراضياً أبعاداً تحافظ على نسب المدخل وتبقى ضمن حد النموذج الأصلي البالغ 2K.
num_inference_stepsاختياري
النوعinteger
الافتراضي30
20 – 50
عدد تكرارات إزالة التشويش المطلوب تنفيذها.
guidance_scaleاختياري
النوعnumber
الافتراضي4
1 – 8
قوة التوجيه النصي للتحرير: زدها لجعل التعديل أكثر التزاماً بالتعليمات.
image_guidance_scaleاختياري
النوعnumber
الافتراضي1
1 – 8
قوة توجيه الصورة المرجعية، مع الحفاظ الأقوى على المدخل عند الإعدادات الأعلى، وعدم وجود CFG للصورة عند 1.0.
cfg_range_startاختياري
النوعnumber
الافتراضي0
0 – 1
نقطة البداية، معبراً عنها بكسر زمني، لتطبيق CFG.
cfg_range_endاختياري
النوعnumber
الافتراضي1
0 – 1
نقطة النهاية، معبراً عنها بكسر زمني، لتطبيق CFG.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المحررة المطلوب إنتاجها.
seedاختياري
النوعinteger | null
بذرة لتوليد صور قابلة للتكرار: يمكن إعادة إنتاج الصورة بدقة بإعادة استخدام بذرتها مع الموجّه الأصلي والصورة المدخلة وإصدار النموذج.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
تحكم فحص السلامة الذي يشمل الصور المدخلة والمولّدة؛ لا يجوز تعطيل الفحص إلا للحسابات المصرح لها، وتُفحص جميع الطلبات الأخرى بصرف النظر عن هذا الإعداد. تفعّل القيمة true الفحص، مع استبدال الصور غير الآمنة بصور سوداء.
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpng
تنسيق ملف الصورة الناتجة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "boogu-image/edit",
  "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": 80,
    "usd": "0.08",
    "charged": 80,
    "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",
        "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/boogu-image/edit.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt