رفتن به محتوا

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"

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

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

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

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

ساخت درخواست

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

پیش‌فرض

متن اختیاری برای هدایت گسترش تصویر. پرامپت‌ها در حال حاضر فقط از انگلیسی و بدون نویسه‌های ویژه پشتیبانی می‌کنند.

•الزامی image_url
یک فایل بیندازید، یا

URL تصویر ورودی.

aspect_ratio

نسبت تصویر نهایی که در صورت ارائه، هر دو مورد `original_image_size` و `original_image_location` را نادیده می‌گیرد.

•الزامی

ابعاد تصویر گسترش‌یافته، مشمول محدودیت مساحتِ کمتر از 5000 × 5000 پیکسل.

پیشرفته negative_prompt · seed · original_image_size · original_image_location
پیش‌فرض

پرامپت متنی منفی برای تولید تصویر.

Seed اختیاری برای بازتولید گسترش: برای بازسازی نتیجه، Seed برگشت‌داده‌شده همراه نتیجه قبلی را ارائه کنید. حذف آن در صورت بی‌نیازی به تکرارپذیری، تولید تصادفی را امکان‌پذیر می‌کند.

ابعاد هدف تصویر منبع در بوم کامل؛ هنگام ارائه aspect_ratio نادیده گرفته می‌شود. برای بهترین نتیجه، پیش‌زمینه یا سوژه اصلی ورودی باید بیش از 15% مساحت بوم را اشغال کند.

مختصات گوشه بالا-چپ برای جای‌گذاری تصویر اصلی روی بوم کامل؛ هر زمان `aspect_ratio` ارائه شود نادیده گرفته می‌شود. اگر موقعیت از بوم خارج شود، تصویر برش می‌خورد؛ این حالت مجاز است.

POST /run/bria/expand?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/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
۰ – ۲٬۱۴۷٬۴۸۳٬۶۴۷
Seed اختیاری برای بازتولید گسترش: برای بازسازی نتیجه، Seed برگشت‌داده‌شده همراه نتیجه قبلی را ارائه کنید. حذف آن در صورت بی‌نیازی به تکرارپذیری، تولید تصادفی را امکان‌پذیر می‌کند.
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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
image
object {url, content_type, file_name, file_size, width, height}تصویر تولیدشده.
seed
integerSeed اعمال‌شده هنگام تولید.

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

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