رفتن به محتوا

Bria Expand (FIBO-Edit-1.5)

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

شناسه مدل bria/fibo-edit-1.5/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/fibo-edit-1.5/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"
  }'

# 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 ویرایش تصویر #image-expansion#outpainting#aspect-ratio#canvas-extension

ابزار اوت‌پینتینگ برای گسترش تصویر به نسبت ابعاد جدید یا بوم سفارشی کمتر از 25 مگاپیکسل

Bria AI · تصویر

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

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

ساخت درخواست

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

توضیح اختیاری محتوای ناحیه افزوده‌شده. تنظیم ساده بوم معمولاً به توضیح نیاز ندارد: حذف آن از مدل می‌خواهد فقط تصویر موجود را گسترش دهد.

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

تصویر مورد استفاده برای گسترش، ارائه‌شده به‌صورت فایل یا URL.

aspect_ratio

تنظیم نسبت تصویر نهایی که تصویر اصلی را در مرکز قرار می‌دهد و بوم پیرامون را گسترش می‌دهد. تعیین آن بر هر دو مورد 'original_image_size' و 'original_image_location' اولویت دارد.

پیشرفته negative_prompt · seed · retain_original_quality · preserve_alpha · return_model_output · canvas_size · original_image_size · original_image_location

بررسی سازگاری برای درخواست‌های نوشته‌شده برای مسیر API گسترش SDXL: ارائه این ورودی پشتیبانی‌نشده رد صریح را فعال می‌کند تا مقدار آن بی‌سروصدا از بین نرود. به‌جای آن از 'prompt' استفاده کنید.

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

ابعاد تصویر گسترش‌یافته همراه با 'original_image_location'. برای بوم نهایی [width, height] را مشخص کنید و مساحت آن را کمتر از 25 مگاپیکسل نگه دارید.

[width, height] هدف برای تصویر اصلی در بوم. ارائه 'aspect_ratio' این تنظیم را نادیده می‌گیرد؛ در غیر این صورت، تصویر پیش از جای‌گذاری به این ابعاد تغییر اندازه می‌دهد.

مختصات جای‌گذاری [x, y] برای گوشه بالا-چپ تصویر اصلی؛ هنگام ارائه 'aspect_ratio' نادیده گرفته می‌شود. جای‌گذاری خارج از مرزهای بوم مجاز است و تصویر اصلی را برش می‌دهد.

POST /run/bria/fibo-edit-1.5/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/fibo-edit-1.5/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"
  }'

# 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 (FIBO-Edit-1.5)

تصویر را فراتر از مرزهایش گسترش می‌دهد. یکی از نه مقدار `aspect_ratio` را انتخاب کنید، یا `canvas_size` را به‌صورت [width, height] با مساحت کمتر از 25 مگاپیکسل، به‌همراه `original_image_size` و `original_image_location` تعیین کنید. `prompt` اختیاری ناحیهٔ جدید را توصیف می‌کند. `retain_original_quality` و `preserve_alpha` به‌صورت پیش‌فرض فعال‌اند و `return_model_output` برای تشخیص خطاهاست.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
تصویر مورد استفاده برای گسترش، ارائه‌شده به‌صورت فایل یا URL.
canvas_sizeاختیاری
نوعinteger[]
≤ ۲ مورد≥ ۲ مورد
ابعاد تصویر گسترش‌یافته همراه با 'original_image_location'. برای بوم نهایی [width, height] را مشخص کنید و مساحت آن را کمتر از 25 مگاپیکسل نگه دارید.
aspect_ratioاختیاری
نوعenum
1:12:33:23:44:34:55:49:1616:9
تنظیم نسبت تصویر نهایی که تصویر اصلی را در مرکز قرار می‌دهد و بوم پیرامون را گسترش می‌دهد. تعیین آن بر هر دو مورد 'original_image_size' و 'original_image_location' اولویت دارد.
original_image_sizeاختیاری
نوعinteger[]
≤ ۲ مورد≥ ۲ مورد
[width, height] هدف برای تصویر اصلی در بوم. ارائه 'aspect_ratio' این تنظیم را نادیده می‌گیرد؛ در غیر این صورت، تصویر پیش از جای‌گذاری به این ابعاد تغییر اندازه می‌دهد.
original_image_locationاختیاری
نوعinteger[]
≤ ۲ مورد≥ ۲ مورد
مختصات جای‌گذاری [x, y] برای گوشه بالا-چپ تصویر اصلی؛ هنگام ارائه 'aspect_ratio' نادیده گرفته می‌شود. جای‌گذاری خارج از مرزهای بوم مجاز است و تصویر اصلی را برش می‌دهد.
promptاختیاری
نوعstring | null
توضیح اختیاری محتوای ناحیه افزوده‌شده. تنظیم ساده بوم معمولاً به توضیح نیاز ندارد: حذف آن از مدل می‌خواهد فقط تصویر موجود را گسترش دهد.
seedاختیاری
نوعinteger | null
۰ – ۲٬۱۴۷٬۴۸۳٬۶۴۷
Seed تولید تصادفی که صرف‌نظر از ارائه در اینجا یا انتخاب تصادفی هنگام حذف، همیشه در پاسخ گنجانده می‌شود. مقداری که از پاسخ قبلی گرفته شود می‌تواند نتیجه آن را بازسازی کند.
negative_promptاختیاری
نوعstring | null
بررسی سازگاری برای درخواست‌های نوشته‌شده برای مسیر API گسترش SDXL: ارائه این ورودی پشتیبانی‌نشده رد صریح را فعال می‌کند تا مقدار آن بی‌سروصدا از بین نرود. به‌جای آن از 'prompt' استفاده کنید.
retain_original_qualityاختیاری
نوعboolean
پیش‌فرضtrue
این گزینه را فعال کنید تا پیکسل‌های اصلی محافظت‌شده با ماسک، بدون نمونه‌برداری مجدد و با وضوح کامل حفظ شوند. مدل تقریباً در یک مگاپیکسل تولید می‌کند و سپس برای بوم‌های بزرگ‌تر بزرگ‌نمایی می‌کند. غیرفعال‌کردن آن نتیجه‌ای یکنواخت و نرم ایجاد می‌کند که ممکن است درز را در پس‌زمینه بافت‌دار پنهان کند.
preserve_alphaاختیاری
نوعboolean
پیش‌فرضtrue
با گسترش کانال آلفای اصلی از طریق تکرار لبه، شفافیت ورودی را در صورت نیاز برای گسترش برش حفظ می‌کند. چون تولید در RGB انجام می‌شود، مدل آلفا تولید نمی‌کند. برای دریافت خروجی RGB تخت‌شده، آن را غیرفعال کنید.
return_model_outputاختیاری
نوعboolean
پیش‌فرضfalse
یک فریم تشخیصی اضافی برگردانید تا خطاهای مدل از خطاهای ترکیب متمایز شوند، بدون تغییر تصویر نهایی. این فریم نتیجه مدل را پیش از درج مجدد تصویر اصلی و ترکیب درزها نشان می‌دهد؛ هر نقص مرزی که در این فریم دیده شود خطای تولید است، نه خطای پس‌پردازش.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/fibo-edit-1.5/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"
  },
  "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,
    "structured_instruction": {},
    "model_output": {
      "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}تصویر حاصل از گسترش.
seed
integerSeed اعمال‌شده هنگام تولید که امکان بازتولید نتیجه را فراهم می‌کند.
structured_instruction
objectپرامپت ساختاریافته استفاده‌شده برای شرطی‌سازی مدل.
model_output
object {url, content_type, file_name, file_size, width, height} | nullفریم ترکیب‌نشده که فقط هنگام فعال‌بودن 'return_model_output' گنجانده می‌شود. این فریم ابعاد بوم درخواستی را دارد و خروجی مدل را بدون محتوای چسبانده یا ترکیب‌شده شامل می‌شود.

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

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