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

Bria Product Shot

التكامل

معرّف النموذج bria/product-shot
# 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/bria/product-shot?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.04 $⁩ 40 رصيد API · ≈ ⁨‏4.19 ₽⁩ تشغيله في هذه الصفحة

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

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

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

إنشاء طلب

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

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

عنوان URL لصورة المنتج لوضعها في مشهد نمط حياة؛ يجب أن تكون الصورة jpeg أو jpg أو png أو webp وألا يتجاوز حجمها 12 MB. إذا تم توفير `image_file` أيضًا، تكون الأولوية لـ `image_url`.

الافتراضي 1

عدد صور المنتج بنمط الحياة لكل موضع (`num_results`). الإجمالي هو عدد المواضع المطلوبة × `num_results` عند `placement_type=manual_placement`، أو `num_results` × 10 عند `placement_type=automatic`.

متقدم ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
الافتراضي
أفلت ملفًا، أو

عنوان URL لصورة مرجعية لتوليد خلفية أو مشهد جديد لصورة المنتج، مع دعم jpeg وjpg وpng وwebp. وفّر واحدًا فقط من `scene_description` أو `ref_image_url`؛ ويُكتب عنوان URL الفارغ كـ "". عند توفير `ref_image_file` أيضًا، تكون الأولوية لـ `ref_image_url`.

placement_type الافتراضي manual_placement

وضع تحديد موضع المنتج، مع خيارين يدويين: يستخدم 'manual_placement' مواضع محددة مسبقًا يتم اختيارها عبر 'manual_placement_selection'، بينما يضبط 'manual_padding' موضع الصورة وحجمها عبر حشو بالبكسل حول المنتج. للاحتفاظ بموضع المصدر، اختر 'original'؛ ولتوليد نتائج عبر 10 مواضع موصى بها للمنتج، اختر 'automatic'.

موجّه باللغة الإنجليزية فقط، دون أحرف خاصة، يصف المشهد أو الخلفية المراد إنشاؤها لصورة المنتج المقدمة.

الافتراضي bottom_center

المواضع المحددة مسبقًا المستخدمة عند اختيار placement_type=manual_placement. اختر من القائمة؛ ويمكن طلب مواضع متعددة معًا.

الافتراضي [1000,1000]

الأبعاد المستهدفة لصورة المنتج النهائية، ولا تنطبق إلا مع placement_type=automatic أو placement_type=manual_placement. للحصول على أفضل النتائج، استهدف نحو 1,000,000 بكسل إجمالًا.

حشو بالبكسل لـ `placement_type=manual_padding`، يُوفَّر بالترتيب [left, right, top, bottom]. لاختيار هذه القيم، احصل أولًا على قصاصة المنتج باستخدام API قصاصة المنتج وافحص أبعادها، ثم مرر تلك القصاصة إلى هذا API مع الحشو المطلوب. استهدف نحو 1,000,000 بكسل إجمالًا بعد الحشو للحصول على أفضل النتائج.

POST /run/bria/product-shot?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.ru/v1/run/bria/product-shot?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Bria Product Shot

يضع المنتج من `image_url` في مشهد تصفه `scene_description` أو تعرضه `ref_image_url`، وليس كليهما. يمكن أن تكون `placement_type` original أو automatic أو manual_placement أو manual_padding، مع عشرة مواضع لـ`manual_placement_selection` وحجم لقطة `shot_size` يقارب 1,000,000 بكسل. يتراوح `num_results` من 1 إلى 4، ويتوفر وضع `fast`.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة المنتج لوضعها في مشهد نمط حياة؛ يجب أن تكون الصورة jpeg أو jpg أو png أو webp وألا يتجاوز حجمها 12 MB. إذا تم توفير `image_file` أيضًا، تكون الأولوية لـ `image_url`.
scene_descriptionاختياري
النوعstring | null
موجّه باللغة الإنجليزية فقط، دون أحرف خاصة، يصف المشهد أو الخلفية المراد إنشاؤها لصورة المنتج المقدمة.
ref_image_urlاختياري
النوعurl · image
الافتراضي
عنوان URL لصورة مرجعية لتوليد خلفية أو مشهد جديد لصورة المنتج، مع دعم jpeg وjpg وpng وwebp. وفّر واحدًا فقط من `scene_description` أو `ref_image_url`؛ ويُكتب عنوان URL الفارغ كـ "". عند توفير `ref_image_file` أيضًا، تكون الأولوية لـ `ref_image_url`.
optimize_descriptionاختياري
النوعboolean
الافتراضيtrue
ما إذا كان تحسين وصف المشهد مفعّلًا.
num_resultsاختياري
النوعinteger
الافتراضي1
1 – 4
عدد صور المنتج بنمط الحياة لكل موضع (`num_results`). الإجمالي هو عدد المواضع المطلوبة × `num_results` عند `placement_type=manual_placement`، أو `num_results` × 10 عند `placement_type=automatic`.
fastاختياري
النوعboolean
الافتراضيtrue
يتحكم في تحديد النموذج السريع.
placement_typeاختياري
النوعenum
الافتراضيmanual_placement
originalautomaticmanual_placementmanual_padding
وضع تحديد موضع المنتج، مع خيارين يدويين: يستخدم 'manual_placement' مواضع محددة مسبقًا يتم اختيارها عبر 'manual_placement_selection'، بينما يضبط 'manual_padding' موضع الصورة وحجمها عبر حشو بالبكسل حول المنتج. للاحتفاظ بموضع المصدر، اختر 'original'؛ ولتوليد نتائج عبر 10 مواضع موصى بها للمنتج، اختر 'automatic'.
original_qualityاختياري
النوعboolean
الافتراضيfalse
خيار تحجيم المخرج المستخدم فقط مع `placement_type=original`: يؤدي false إلى تحجيم الصورة إلى 1 ميغابكسل (1MP) دون تغيير نسبة أبعادها، بينما يحافظ true على أبعاد المدخل.
shot_sizeاختياري
النوعinteger[]
الافتراضي[1000,1000]
الأبعاد المستهدفة لصورة المنتج النهائية، ولا تنطبق إلا مع placement_type=automatic أو placement_type=manual_placement. للحصول على أفضل النتائج، استهدف نحو 1,000,000 بكسل إجمالًا.
manual_placement_selectionاختياري
النوعenum
الافتراضيbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
المواضع المحددة مسبقًا المستخدمة عند اختيار placement_type=manual_placement. اختر من القائمة؛ ويمكن طلب مواضع متعددة معًا.
padding_valuesاختياري
النوعinteger[]
حشو بالبكسل لـ `placement_type=manual_padding`، يُوفَّر بالترتيب [left, right, top, bottom]. لاختيار هذه القيم، احصل أولًا على قصاصة المنتج باستخدام API قصاصة المنتج وافحص أبعادها، ثم مرر تلك القصاصة إلى هذا API مع الحشو المطلوب. استهدف نحو 1,000,000 بكسل إجمالًا بعد الحشو للحصول على أفضل النتائج.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/product-shot",
  "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
      }
    ]
  },
  "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, content_type, file_name, file_size, width, height}الصور الناتجة عن النموذج.

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

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