رفتن به محتوا

Bria Background Replace

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

شناسه مدل bria/background/replace
# 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/background/replace?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 · تصویر

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

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

ساخت درخواست

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

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

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

تصویر منبعی که محتوا از آن پاک می‌شود.

num_images پیش‌فرض 1

تعداد تصاویر برای تولید.

پیشرفته negative_prompt · ref_image_url · seed · refine_prompt · fast
پیش‌فرض

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

پیش‌فرض
یک فایل بیندازید، یا

یک مرجع jpeg، jpg، png یا webp را از طریق URL برای هدایت ایجاد پس‌زمینه جدید ارائه کنید، یا برای نداشتن URL از "" استفاده کنید. دقیقاً یکی از bg_prompt و ref_image_url باید ارائه شود. اگر ref_image_file نیز همراه ref_image_url ارائه شود، URL اولویت دارد.

seed برای تصاویر تکرارپذیر: پرامپت و seed یکسان، در صورت ثابت‌بودن نسخه مدل، تصویر یکسانی تولید می‌کنند.

POST /run/bria/background/replace?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/background/replace?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 Background Replace

پس‌زمینه تصویر موجود در `image_url` را جایگزین می‌کند. صحنه جدید را با `prompt` توصیف کنید یا `ref_image_url` بدهید، اما نه هر دو را. گزینه‌ها شامل `negative_prompt`، اصلاح پرامپت، کلید تغییر مدل `fast` و `num_images` از 1 تا 4 هستند. `seed` بین 0 و 2147483647 نتایج را تکرارپذیر می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
تصویر منبعی که محتوا از آن پاک می‌شود.
ref_image_urlاختیاری
نوعurl · image
پیش‌فرض
یک مرجع jpeg، jpg، png یا webp را از طریق URL برای هدایت ایجاد پس‌زمینه جدید ارائه کنید، یا برای نداشتن URL از "" استفاده کنید. دقیقاً یکی از bg_prompt و ref_image_url باید ارائه شود. اگر ref_image_file نیز همراه ref_image_url ارائه شود، URL اولویت دارد.
promptاختیاری
نوعstring | null
پرامپت متنی برای هدایت تولید تصویر.
negative_promptاختیاری
نوعstring
پیش‌فرض
پرامپت متنی منفی برای تولید تصویر.
refine_promptاختیاری
نوعboolean
پیش‌فرضtrue
تعیین می‌کند که پالایش پرامپت فعال باشد یا نه.
seedاختیاری
نوعinteger | null
۰ – ۲٬۱۴۷٬۴۸۳٬۶۴۷
seed برای تصاویر تکرارپذیر: پرامپت و seed یکسان، در صورت ثابت‌بودن نسخه مدل، تصویر یکسانی تولید می‌کنند.
fastاختیاری
نوعboolean
پیش‌فرضtrue
تعیین می‌کند که مدل سریع انتخاب شود یا نه.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۴
تعداد تصاویر برای تولید.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/background/replace",
  "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
      }
    ],
    "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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of object {url, content_type, file_name, file_size, width, height}تصاویر تولیدشده توسط مدل.
seed
integerSeed اعمال‌شده هنگام تولید.

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

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