رفتن به محتوا

Fibo 2.0 Edit

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

شناسه مدل bria/fibo-2/edit
# 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/fibo-2/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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"

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

دریافت کلید API
Bria AI ویرایش تصویر #image-editing#instruction-based-image-editing#reference-images#e-commerce

ویرایشگر مبتنی بر دستور برای 1 تا 4 تصویر، با ماسک اختیاری برای ویرایش ناحیه‌ای یک تصویر

Bria AI · تصویر

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

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

ساخت درخواست

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

•الزامی image_urls
یک فایل بیندازید، یا · حداکثر 4

ورودی‌های ویرایش که بر اساس ترتیب ارسال به‌صورت <image_1>، <image_2> و غیره برای استفاده در دستور نمایه‌گذاری می‌شوند. 1–4 تصویر را به‌صورت فایل یا URL ارائه کنید.

تنظیم نسبت تصویر برای خروجی تقریباً یک مگاپیکسلی؛ یک تصویر ورودی، صرف‌نظر از این تنظیم، نسبت خود را حفظ می‌کند. با چند ورودی، حذف تنظیم از نسبت تصویر اول استفاده می‌کند.

پیشرفته instruction · mask · seed · vgl

جهت‌های ویرایش که در صورت ارائه همراه با 'vgl'، آن را تغییر می‌دهند. در غیر این صورت، درخواست آزاد به سند VGL گسترش یافته و در پاسخ گنجانده می‌شود.

mask_url
یک فایل بیندازید، یا

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

پیش‌فرض 5555

Seed کنترل‌کننده تصادفی‌بودن برای نتایج قابل‌بازآفرینی، در بازه 0 تا 2147483647.

سند VGL (Visual Generation Language) که می‌تواند از پاسخ قبلی دوباره استفاده شود. همراه با 'instruction'، تصویر اول را نشان می‌دهد و مبنای ویرایش را فراهم می‌کند؛ بدون 'instruction'، ویرایش را بدون تغییر مشخص می‌کند و باید شامل 'edit_instruction' باشد.

POST /run/bria/fibo-2/edit?wait=20 قیمت → ⁨‎$۰٫۰۴⁩
# 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/fibo-2/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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

درباره Fibo 2.0 Edit

یک تا چهار تصویر موجود در `image_urls` را ویرایش می‌کند؛ `instruction` با ارجاع به آن‌ها به‌شکل <image_1>، <image_2> و مانند آن نوشته می‌شود. برای تعویض پس‌زمینه و بازچینی محصول کاربرد دارد. `mask_url` در درخواست‌های تک‌تصویری ویرایش را به یک ناحیه محدود می‌کند. `aspect_ratio` دارای 16 مقدار است و می‌توان یک سند ساختاریافتهٔ `vgl` را ارسال یا دوباره استفاده کرد.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlsالزامی images
نوعurl[] · image
≤ ۴ مورد
ورودی‌های ویرایش که بر اساس ترتیب ارسال به‌صورت <image_1>، <image_2> و غیره برای استفاده در دستور نمایه‌گذاری می‌شوند. 1–4 تصویر را به‌صورت فایل یا URL ارائه کنید.
instructionاختیاری
نوعstring | null
جهت‌های ویرایش که در صورت ارائه همراه با 'vgl'، آن را تغییر می‌دهند. در غیر این صورت، درخواست آزاد به سند VGL گسترش یافته و در پاسخ گنجانده می‌شود.
aspect_ratioاختیاری
نوعenum
1:11:21:31:41:52:12:33:13:23:44:14:34:55:15:49:16
+5 مورد دیگر9:2110:1616:916:1021:9
تنظیم نسبت تصویر برای خروجی تقریباً یک مگاپیکسلی؛ یک تصویر ورودی، صرف‌نظر از این تنظیم، نسبت خود را حفظ می‌کند. با چند ورودی، حذف تنظیم از نسبت تصویر اول استفاده می‌کند.
seedاختیاری
نوعinteger
پیش‌فرض5555
۰ – ۲٬۱۴۷٬۴۸۳٬۶۴۷
Seed کنترل‌کننده تصادفی‌بودن برای نتایج قابل‌بازآفرینی، در بازه 0 تا 2147483647.
mask_urlاختیاری mask
نوعurl · image
ماسک ویرایش برای درخواست‌های دارای یک تصویر، ارائه‌شده به‌صورت فایل یا URL با ابعادی مطابق همان تصویر. نواحی سفید نشان‌دهنده نواحی تولید مجدد و نواحی سیاه نشان‌دهنده همه بخش‌های دیگر هستند. نتیجه از ابعاد ورودی استفاده می‌کند و پیکسل‌های خارج از ماسک را حفظ می‌کند.
vglاختیاری
نوعobject
سند VGL (Visual Generation Language) که می‌تواند از پاسخ قبلی دوباره استفاده شود. همراه با 'instruction'، تصویر اول را نشان می‌دهد و مبنای ویرایش را فراهم می‌کند؛ بدون 'instruction'، ویرایش را بدون تغییر مشخص می‌کند و باید شامل 'edit_instruction' باشد.
vgl.short_descriptionاختیاری
نوعstring | null
توضیح کوتاه تصویر خروجی موردنظر.
vgl.objectsاختیاری
نوعobject[]
پیش‌فرض[]
محتوای تصویر تولیدشده را به‌صورت فهرست مشخص کنید و ویژگی‌های هر شیء و روابط آن با سایر اشیای تصویرشده را ثبت کنید.
vgl.objects[].descriptionاختیاری
نوعstring | null
توضیح شیء خروجی موردنظر.
vgl.objects[].locationاختیاری
نوعstring | null
موقعیت شیء در تصویر.
vgl.objects[].relationshipالزامی
نوعstring
رابطه شیء با اشیای دیگر تصویر.
vgl.objects[].relative_sizeاختیاری
نوعstring | null
اندازه شیء نسبت به تصویر.
vgl.objects[].shape_and_colorاختیاری
نوعstring | null
شکل و رنگ شیء.
vgl.objects[].textureاختیاری
نوعstring | null
بافت شیء.
vgl.objects[].appearance_detailsاختیاری
نوعstring | null
جزئیات توصیف‌کننده ظاهر شیء.
vgl.objects[].number_of_objectsاختیاری
نوعinteger | null
تعداد اشیا در تصویر.
vgl.objects[].poseاختیاری
نوعstring | null
ژست شیء تصویرشده.
vgl.objects[].expressionاختیاری
نوعstring | null
حالت چهره نمایش‌داده‌شده توسط شیء تصویرشده.
vgl.objects[].clothingاختیاری
نوعstring | null
لباس پوشیده‌شده توسط شیء تصویرشده.
vgl.objects[].actionاختیاری
نوعstring | null
عمل انجام‌شده توسط شیء تصویرشده.
vgl.objects[].genderاختیاری
نوعstring | null
جنسیت شیء تصویرشده.
vgl.objects[].skin_tone_and_textureاختیاری
نوعstring | null
بافت و تُن پوست شیء تصویرشده.
vgl.objects[].orientationاختیاری
نوعstring | null
جهت‌گیری شیء تصویرشده.
vgl.background_settingاختیاری
نوعstring | null
پس‌زمینه تصویر تولیدشده.
vgl.lightingاختیاری
نوعobject
نورپردازی تصویر تولیدشده.
vgl.lighting.conditionsاختیاری
نوعstring | null
شرایط نورپردازی تصویر تولیدشده.
vgl.lighting.directionاختیاری
نوعstring | null
جهت نورپردازی تصویر تولیدشده.
vgl.lighting.shadowsاختیاری
نوعstring | null
سایه‌هایی که باید در تصویر تولیدشده نمایش داده شوند.
vgl.aestheticsاختیاری
نوعobject
ویژگی‌های زیبایی‌شناختی تصویر تولیدشده.
vgl.aesthetics.compositionاختیاری
نوعstring | null
ترکیب‌بندی تصویر تولیدشده.
vgl.aesthetics.color_schemeاختیاری
نوعstring | null
پالت رنگ تصویر تولیدشده.
vgl.aesthetics.mood_atmosphereاختیاری
نوعstring | null
حال‌وهوا و فضای تصویر تولیدشده.
vgl.photographic_characteristicsاختیاری
نوعobject
ویژگی‌های عکاسانه تصویر تولیدشده.
vgl.photographic_characteristics.depth_of_fieldاختیاری
نوعstring | null
عمق میدان تصویر تولیدشده.
vgl.photographic_characteristics.focusاختیاری
نوعstring | null
تمرکز تصویر تولیدشده.
vgl.photographic_characteristics.camera_angleاختیاری
نوعstring | null
زاویه دوربین تصویر تولیدشده.
vgl.photographic_characteristics.lens_focal_lengthاختیاری
نوعstring | null
تنظیم لنز تصویر تولیدشده، بیان‌شده به‌صورت فاصله کانونی.
vgl.style_mediumاختیاری
نوعstring | null
رسانه سبکی تصویر تولیدشده.
vgl.text_renderاختیاری
نوعobject[]
پیش‌فرض[]
فهرست ورودی‌های متنی برای گنجاندن در تصویر.
vgl.text_render[].textالزامی
نوعstring
متن برای رندر، که به‌صورت بصری نیز به fibo-2 به‌عنوان تصویر ارائه می‌شود تا بازتولید دقیق عبارت ارائه‌شده آسان‌تر شود.
vgl.text_render[].locationاختیاری
نوعstring | null
جای‌گذاری متن در تصویر.
vgl.text_render[].sizeاختیاری
نوعstring | null
اندازه متن در تصویر.
vgl.text_render[].colorاختیاری
نوعstring | null
رنگ استفاده‌شده برای متن.
vgl.text_render[].fontاختیاری
نوعstring | null
سبک قلم متن.
vgl.text_render[].appearance_detailsاختیاری
نوعstring | null
جزئیات مهم اضافی درباره ظاهر متن.
vgl.contextاختیاری
نوعstring | null
زمینه تصویر تولیدشده.
vgl.artistic_styleاختیاری
نوعstring | null
سبک هنری تصویر تولیدشده.
vgl.edit_instructionاختیاری
نوعstring | null
دستوری برای توضیح نحوه ویرایش تصویر.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/fibo-2/edit",
  "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_urls": [
      "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
    },
    "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
      }
    ],
    "vgl": {}
  },
  "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 کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
image
object {url, content_type, file_name, file_size, width, height}تصویر حاصل از ویرایش.
images
array of object {url, content_type, file_name, file_size, width, height}فهرست تصاویر مطابق قالبی که دیگر برنامه‌های FIBO برمی‌گردانند؛ تنها ورودی آن همان تصویر است.
vgl
objectVGL استفاده‌شده برای ویرایش، شامل `edit_instruction`.

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

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