رفتن به محتوا

FLUX 2 Pro Outpaint

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

شناسه مدل flux-2-pro/outpaint
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/flux-2-pro/outpaint?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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

دریافت کلید API
Black Forest Labs ویرایش تصویر #image-to-image#outpaint#outpainting

گسترش تصویر فراتر از مرزها با تعداد پیکسل مشخص در هر طرف، با حالت باکیفیت یا سریع

Black Forest Labs · تصویر

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

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

ساخت درخواست

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

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

URL تصویر منبع برای گسترش outpainting.

پیشرفته mode · output_format · expand_top · expand_bottom · expand_left · expand_right · auto_crop · enable_safety_checker
mode پیش‌فرض high

انتخاب کیفیت و سرعت outpainting: `fast` بیشتر صحنه‌ها را به‌خوبی گسترش می‌دهد و بسیار سریع‌تر اجرا می‌شود، اما ممکن است وفاداری کاهش یابد. برای بیشترین وفاداری، از `high`، یعنی مقدار پیش‌فرض، استفاده کنید.

output_format پیش‌فرض jpeg

قالب فایل تصویر نهایی.

پیش‌فرض 0

تعداد پیکسل‌های افزوده‌شده بالای تصویر.

پیش‌فرض 0

تعداد پیکسل‌های افزوده‌شده پایین تصویر.

پیش‌فرض 0

تعداد پیکسل‌های افزوده‌شده در امتداد لبهٔ چپ تصویر.

پیش‌فرض 0

تعداد پیکسل‌های افزوده‌شده در امتداد لبهٔ راست تصویر.

POST /run/flux-2-pro/outpaint?wait=20 قیمت → ⁨‎$۰٫۴۰⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/flux-2-pro/outpaint?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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره FLUX 2 Pro Outpaint

با پر کردن محتوای جدید خارج از لبه‌ها، تصویر منبع (`image_url`) را گسترش می‌دهد. از `expand_top`، `expand_bottom`، `expand_left` و `expand_right` استفاده کنید که هرکدام بین 0 تا 2048 پیکسل هستند. `mode` برای بیشترین وفاداری `high` و برای نتیجهٔ سریع‌تر `fast` است؛ `auto_crop` مراجع ناسازگار با بوم جدید را مدیریت می‌کند. خروجی jpeg یا png است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
URL تصویر منبع برای گسترش outpainting.
expand_topاختیاری
نوعinteger
پیش‌فرض0
۰ – ۲٬۰۴۸
تعداد پیکسل‌های افزوده‌شده بالای تصویر.
expand_bottomاختیاری
نوعinteger
پیش‌فرض0
۰ – ۲٬۰۴۸
تعداد پیکسل‌های افزوده‌شده پایین تصویر.
expand_leftاختیاری
نوعinteger
پیش‌فرض0
۰ – ۲٬۰۴۸
تعداد پیکسل‌های افزوده‌شده در امتداد لبهٔ چپ تصویر.
expand_rightاختیاری
نوعinteger
پیش‌فرض0
۰ – ۲٬۰۴۸
تعداد پیکسل‌های افزوده‌شده در امتداد لبهٔ راست تصویر.
auto_cropاختیاری
نوعboolean
پیش‌فرضfalse
گزینهٔ برش خودکار بخش‌هایی از تصویر مرجع که خارج از بوم گسترش‌یافته قرار می‌گیرند.
modeاختیاری
نوعenum
پیش‌فرضhigh
highfast
انتخاب کیفیت و سرعت outpainting: `fast` بیشتر صحنه‌ها را به‌خوبی گسترش می‌دهد و بسیار سریع‌تر اجرا می‌شود، اما ممکن است وفاداری کاهش یابد. برای بیشترین وفاداری، از `high`، یعنی مقدار پیش‌فرض، استفاده کنید.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
کلید بررسی ایمنی که حالت خاموش آن فقط برای حساب‌های مجاز پذیرفته می‌شود. همه درخواست‌های فاقد این مجوز بررسی ایمنی می‌شوند.
output_formatاختیاری
نوعenum
پیش‌فرضjpeg
jpegpng
قالب فایل تصویر نهایی.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "flux-2-pro/outpaint",
  "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": 400,
    "usd": "0.40",
    "charged": 400,
    "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
      }
    ]
  },
  "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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/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}تصاویر تولیدشده از طریق outpainting.

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

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