رفتن به محتوا

Bria Product Dimensions

یکپارچه‌سازی

شناسه مدل bria/product-dimensions
# 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/product-dimensions?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "example",
    "dimensions": [
      {
        "name": "height",
        "position": "left",
        "unit": "cm",
        "value": 22
      },
      {
        "name": "width_bottom",
        "position": "bottom",
        "unit": "cm",
        "value": 7
      }
    ],
    "style": "default"
  }'

# 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"

این درخواست: ⁨‎$۰٫۰۴⁩ ۴۰ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Bria AI · تصویر

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

style •الزامی

سبک استفاده‌شده برای رندر.

•الزامی

ورودی تصویر محصول، ارائه‌شده از طریق پیوند به یک تصویر عمومی یا رمزگذاری بایت‌های خام آن به‌صورت base64.

•الزامی

اندازه‌گذاری‌هایی که باید رسم شوند؛ حداقل یک مورد لازم است.

پیشرفته title_position · output_format · units_display · title · background · output_size · proportional_lines · sync · weight · capacity
title_position پیش‌فرض top_center

موقعیت عنوان در امتداد بالای تصویر.

output_format پیش‌فرض png

انتخاب خروجی رندرشده: png، jpeg یا dual که هم یک ترکیب و هم یک overlay شفاف برمی‌گرداند.

units_display پیش‌فرض single

سبک نمایش برچسب هنگام ارائه واحدها در قالب اصلی و ثانویه.

عنوان اختیاری که بالای محصول نمایش داده می‌شود.

پیش‌فرض white

رنگ مشخص‌شده به‌صورت مقدار hex یا white، cream یا charcoal.

پیش‌فرض 2200

طول هر ضلع خروجی مربعی، برحسب پیکسل.

نشان اختیاری نمایش‌دهنده وزن در زیر محصول.

نشان اختیاری نمایش‌دهنده ظرفیت در زیر محصول.

POST /run/bria/product-dimensions?wait=20 قیمت → ⁨‎$۰٫۰۴⁩
# 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/product-dimensions?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "example",
    "dimensions": [
      {
        "name": "height",
        "position": "left",
        "unit": "cm",
        "value": 22
      },
      {
        "name": "width_bottom",
        "position": "bottom",
        "unit": "cm",
        "value": 7
      }
    ],
    "style": "default"
  }'

# 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 Product Dimensions

`image` محصول و حداقل یک مورد در `dimensions` را می‌گیرد و خطوط اندازه‌گیری برچسب‌دار را پیرامون محصول رسم می‌کند. `style` را (پیش‌فرض، childlike یا elegant)، `title` را با حداکثر 80 نویسه، رنگ پس‌زمینه و `output_size` مربعی از 256 تا 2200 پیکسل انتخاب کنید. خروجی می‌تواند png، jpeg یا ترکیب دوگانه با لایه‌پوشان شفاف باشد.

پارامترها

نامنوع پیش‌فرضمجاز توضیحات
title_positionاختیاری
نوعenum
پیش‌فرضtop_center
top_lefttop_centertop_right
موقعیت عنوان در امتداد بالای تصویر.
proportional_linesاختیاری
نوعboolean
پیش‌فرضtrue
طول خطوط اندازه‌گذاری را متناسب با اندازه‌هایشان کنید.
syncاختیاری
نوعboolean
پیش‌فرضfalse
حالت تحویل تصاویر تولیدشده: true داده base64 جاسازی‌شده را به‌جای پیوندهای CDN انتخاب می‌کند.
imageالزامی
نوعstring
ورودی تصویر محصول، ارائه‌شده از طریق پیوند به یک تصویر عمومی یا رمزگذاری بایت‌های خام آن به‌صورت base64.
dimensionsالزامی
نوعobject[]
اندازه‌گذاری‌هایی که باید رسم شوند؛ حداقل یک مورد لازم است.
dimensions[].nameالزامی
نوعenum
heightwidth_bottomwidth_top
اندازه‌ای که باید نمایش داده شود؛ طول و عمق عمداً در دسترس نیستند.
dimensions[].valueالزامی
نوعnumber
> ۰
مقدار اندازه‌گیری فیزیکی.
dimensions[].unitالزامی
نوعenum
mmcmmin"ft'
واحد استفاده‌شده برای اندازه‌گیری فیزیکی.
dimensions[].positionاختیاری
نوعenum
topbottomleftright
سمتی که اندازه‌گذاری در آن ظاهر می‌شود. اگر حذف شود، نام اندازه مقدار پیش‌فرض را تعیین می‌کند.
styleالزامی
نوعenum
defaultchildlikeelegant
سبک استفاده‌شده برای رندر.
titleاختیاری
نوعstring | null
≤ ۸۰ نویسه
عنوان اختیاری که بالای محصول نمایش داده می‌شود.
output_sizeاختیاری
نوعinteger
پیش‌فرض2200
۲۵۶ – ۲٬۲۰۰
طول هر ضلع خروجی مربعی، برحسب پیکسل.
output_formatاختیاری
نوعenum
پیش‌فرضpng
pngjpegdual
انتخاب خروجی رندرشده: png، jpeg یا dual که هم یک ترکیب و هم یک overlay شفاف برمی‌گرداند.
backgroundاختیاری
نوعstring
پیش‌فرضwhite
رنگ مشخص‌شده به‌صورت مقدار hex یا white، cream یا charcoal.
units_displayاختیاری
نوعenum
پیش‌فرضsingle
singledual_bulletdual_slashdual_parens
سبک نمایش برچسب هنگام ارائه واحدها در قالب اصلی و ثانویه.
weightاختیاری
نوعobject
نشان اختیاری نمایش‌دهنده وزن در زیر محصول.
weight.valueالزامی
نوعnumber
> ۰
weight.unitالزامی
نوعenum
lbozgkg
weight.labelاختیاری
نوعenum
پیش‌فرضWeight
WeightNet Weight
capacityاختیاری
نوعobject
نشان اختیاری نمایش‌دهنده ظرفیت در زیر محصول.
capacity.valueالزامی
نوعnumber
> ۰
capacity.unitالزامی
نوعenum
fl_ozmllqtgalcups
الزامی

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/product-dimensions",
  "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": "example",
    "dimensions": [
      {
        "name": "height",
        "position": "left",
        "unit": "cm",
        "value": 22
      },
      {
        "name": "width_bottom",
        "position": "bottom",
        "unit": "cm",
        "value": 7
      }
    ],
    "style": "default"
  },
  "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
    },
    "transparent_overlay": {
      "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
image
object {url, content_type, file_name, file_size, width, height}تصویر رندرشده‌ای که اندازه‌های محصول را نشان می‌دهد.
transparent_overlay
object {url, content_type, file_name, file_size, width, height} | nullOverlay شفاف که فقط وقتی output_format روی dual تنظیم شده باشد درج می‌شود.

مدل‌های بیشتر: ویرایش تصویر

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/bria/product-dimensions.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt