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

Bria Background Replace

التكامل

معرّف النموذج bria/background/replace
# 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/bria/background/replace?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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.04 $⁩ 40 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Bria AI · صورة

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

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

إنشاء طلب

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

موجّه نصي يوجّه توليد الصورة.

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

الصورة المصدر التي سيُمحى منها المحتوى.

num_images الافتراضي 1

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

متقدم negative_prompt · ref_image_url · seed · refine_prompt · fast
الافتراضي

موجّه نصي سلبي لتوليد الصورة.

الافتراضي
أفلت ملفًا، أو

وفّر مرجعًا بتنسيق jpeg أو jpg أو png أو webp عبر عنوان URL لتوجيه إنشاء الخلفية الجديدة، أو استخدم "" لعدم استخدام عنوان URL. يجب توفير واحد فقط من bg_prompt وref_image_url. إذا تم توفير ref_image_file أيضًا مع ref_image_url، فستكون الأولوية لعنوان URL.

بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.

POST /run/bria/background/replace?wait=20 عرض السعر → ⁨‏0.04 $⁩
# 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/bria/background/replace?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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

حول Bria Background Replace

يستبدل خلفية الصورة في `image_url`. صِف المشهد الجديد باستخدام `prompt` أو وفّر `ref_image_url`، وليس كليهما. تشمل الخيارات `negative_prompt`، وتحسين المطالبة، ومفتاح تبديل نموذج `fast`، و`num_images` من 1 إلى 4. تجعل `seed` بين 0 و2147483647 النتائج قابلة للتكرار.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
الصورة المصدر التي سيُمحى منها المحتوى.
ref_image_urlاختياري
النوعurl · image
الافتراضي
وفّر مرجعًا بتنسيق jpeg أو jpg أو png أو webp عبر عنوان URL لتوجيه إنشاء الخلفية الجديدة، أو استخدم "" لعدم استخدام عنوان URL. يجب توفير واحد فقط من bg_prompt وref_image_url. إذا تم توفير ref_image_file أيضًا مع ref_image_url، فستكون الأولوية لعنوان URL.
promptاختياري
النوعstring | null
موجّه نصي يوجّه توليد الصورة.
negative_promptاختياري
النوعstring
الافتراضي
موجّه نصي سلبي لتوليد الصورة.
refine_promptاختياري
النوعboolean
الافتراضيtrue
يتحكم في تفعيل تحسين الموجّه.
seedاختياري
النوعinteger | null
0 – 2,147,483,647
بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.
fastاختياري
النوعboolean
الافتراضيtrue
يتحكم في تحديد النموذج السريع.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب إنتاجها.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/background/replace",
  "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": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "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
      }
    ],
    "seed": 42
  },
  "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, content_type, file_name, file_size, width, height}الصور الناتجة عن النموذج.
seed
integerالبذرة المطبقة أثناء التوليد.

مزيد من النماذج: تحرير الصور

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