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

Bria Expand Image

التكامل

معرّف النموذج bria/expand
# 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/expand?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",
    "canvas_size": [
      1200,
      674
    ]
  }'

# 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
أفلت ملفًا، أو

عنوان URL لصورة المدخل.

aspect_ratio

نسبة أبعاد الصورة النهائية التي تتجاوز، عند توفيرها، كلًا من `original_image_size` و`original_image_location`.

•مطلوب

أبعاد الصورة الموسعة، مع الخضوع لحد مساحة أقل تمامًا من 5000 × 5000 بكسل.

متقدم negative_prompt · seed · original_image_size · original_image_location
الافتراضي

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

بذرة اختيارية لإعادة إنتاج التوسعة: وفّر البذرة التي أعادتها نتيجة سابقة لإعادة إنشائها. ويتيح حذفها توليدًا عشوائيًا عند عدم الحاجة إلى قابلية التكرار.

الأبعاد المستهدفة للصورة المصدر داخل اللوحة الكاملة؛ تُتجاهل عند توفير aspect_ratio. للحصول على أفضل النتائج، ينبغي أن يشغل العنصر الأمامي أو الرئيسي في المدخل أكثر من 15% من مساحة اللوحة.

إحداثيات الزاوية العلوية اليسرى التي تحدد موضع الصورة الأصلية على اللوحة الكاملة، وتُتجاهل عند توفير `aspect_ratio`. ينتج عن تجاوز الموضع حدود اللوحة اقتطاع، وهو أمر مسموح.

POST /run/bria/expand?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/expand?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",
    "canvas_size": [
      1200,
      674
    ]
  }'

# 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 Expand Image

يوسّع الصورة الموجودة في `image_url` إلى لوحة أكبر يحددها `canvas_size`، على أن تبقى المساحة أقل من 5000x5000 بكسل. وبدلاً من ذلك، استخدم `aspect_ratio` (1:1، 2:3، 3:2، 3:4، 4:3، 4:5، 5:4، 9:16، 16:9)، إذ تكون له الأولوية على الحجم والموقع اليدويين. يمكنك وضع الصورة الأصلية باستخدام `original_image_size` و`original_image_location`، وتوجيه التعبئة باستخدام `prompt` باللغة الإنجليزية.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة المدخل.
canvas_sizeمطلوب
النوعinteger[]
أبعاد الصورة الموسعة، مع الخضوع لحد مساحة أقل تمامًا من 5000 × 5000 بكسل.
aspect_ratioاختياري
النوعenum
1:12:33:23:44:34:55:49:1616:9
نسبة أبعاد الصورة النهائية التي تتجاوز، عند توفيرها، كلًا من `original_image_size` و`original_image_location`.
original_image_sizeاختياري
النوعinteger[]
الأبعاد المستهدفة للصورة المصدر داخل اللوحة الكاملة؛ تُتجاهل عند توفير aspect_ratio. للحصول على أفضل النتائج، ينبغي أن يشغل العنصر الأمامي أو الرئيسي في المدخل أكثر من 15% من مساحة اللوحة.
original_image_locationاختياري
النوعinteger[]
إحداثيات الزاوية العلوية اليسرى التي تحدد موضع الصورة الأصلية على اللوحة الكاملة، وتُتجاهل عند توفير `aspect_ratio`. ينتج عن تجاوز الموضع حدود اللوحة اقتطاع، وهو أمر مسموح.
promptاختياري
النوعstring
الافتراضي
نص اختياري يوجّه توسيع الصورة. تدعم الموجّهات حاليًا اللغة الإنجليزية فقط، من دون أحرف خاصة.
seedاختياري
النوعinteger | null
0 – 2,147,483,647
بذرة اختيارية لإعادة إنتاج التوسعة: وفّر البذرة التي أعادتها نتيجة سابقة لإعادة إنشائها. ويتيح حذفها توليدًا عشوائيًا عند عدم الحاجة إلى قابلية التكرار.
negative_promptاختياري
النوعstring
الافتراضي
موجّه نصي سلبي لتوليد الصورة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/expand",
  "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",
    "canvas_size": [
      1200,
      674
    ]
  },
  "output": {
    "image": {
      "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
image
object {url, content_type, file_name, file_size, width, height}الصورة الناتجة عن التوليد.
seed
integerالبذرة المطبقة أثناء التوليد.

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

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