رفتن به محتوا

Flux 3 Image · Edit Image

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

شناسه مدل blackforestlabs/flux-3/edit-image
# 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/blackforestlabs/flux-3/edit-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

دریافت کلید API
Black Forest Labs ویرایش تصویر خروجی 4Kحداکثر 4k #flux-3-image#black-forest-labs#multi-reference

ویرایشگر تصویر FLUX 3 برای ویرایش موضعی و ترکیب حداکثر 10 تصویر مرجع

Black Forest Labs · تصویر

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

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

ساخت درخواست

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

•الزامی

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

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

تصاویر مرجع ارائه‌شده از طریق URL یا URI داده؛ نسبت تصویر خودکار از تصویر 1 در دنباله تا تصویر 10 پیروی می‌کند. هر دو بُعد باید حداقل 256 پیکسل باشند. کوچک‌سازی خودکار، تصاویر بزرگ‌تر را بدون تغییر تناسب آن‌ها به حداکثر 4 مگاپیکسل محدود می‌کند.

resolution پیش‌فرض 1k

سطح وضوح خروجی؛ تولید در 4k ممکن است چند دقیقه طول بکشد.

پیش‌فرض auto

نسبت تصویر خروجی. هنگام ویرایش، Auto با نسبت نخستین تصویر مرجع تطبیق می‌یابد.

پیشرفته output_format · version · safety_tolerance · enable_prompt_expansion
output_format پیش‌فرض jpeg

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

پیش‌فرض latest

نسخه مدلی که باید استفاده شود.

پیش‌فرض 2

تحمل ایمنی از سخت‌گیرانه‌ترین تنظیم، 0، تا 4.

POST /run/blackforestlabs/flux-3/edit-image?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/blackforestlabs/flux-3/edit-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

درباره Flux 3 Image · Edit Image

تصویر را ویرایش می‌کند یا از 1 تا 10 مرجع در `image_urls` نتیجه می‌سازد؛ هر مرجع باید حداقل 256 پیکسل در هر ضلع داشته باشد. `aspect_ratio` را از میان 14 گزینه انتخاب کنید یا روی auto بگذارید تا از مرجع اول پیروی کند. `resolution` گزینه‌های 512sq، 768sq، 1k، 2k و 4k را ارائه می‌دهد و 4k ممکن است چند دقیقه طول بکشد. گسترش اختیاری پرامپت و خروجی jpeg یا png در دسترس است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
پرامپت هدایت‌کننده تولید تصویر.
image_urlsالزامی images
نوعurl[] · image
≤ ۱۰ مورد
تصاویر مرجع ارائه‌شده از طریق URL یا URI داده؛ نسبت تصویر خودکار از تصویر 1 در دنباله تا تصویر 10 پیروی می‌کند. هر دو بُعد باید حداقل 256 پیکسل باشند. کوچک‌سازی خودکار، تصاویر بزرگ‌تر را بدون تغییر تناسب آن‌ها به حداکثر 4 مگاپیکسل محدود می‌کند.
aspect_ratioاختیاری
نوعenum
پیش‌فرضauto
auto21:92:116:93:27:54:35:41:14:53:45:72:39:161:2
نسبت تصویر خروجی. هنگام ویرایش، Auto با نسبت نخستین تصویر مرجع تطبیق می‌یابد.
resolutionاختیاری
نوعenum
پیش‌فرض1k
512sq768sq1k2k4k
سطح وضوح خروجی؛ تولید در 4k ممکن است چند دقیقه طول بکشد.
enable_prompt_expansionاختیاری
نوعboolean
پیش‌فرضfalse
گسترش پرامپت را بدون تغییر معنای موردنظر یا نقش مراجع کنترل می‌کند.
safety_toleranceاختیاری
نوعinteger
پیش‌فرض2
۰ – ۴
تحمل ایمنی از سخت‌گیرانه‌ترین تنظیم، 0، تا 4.
output_formatاختیاری
نوعenum
پیش‌فرضjpeg
jpegpng
قالب فایل تصویر نهایی.
versionاختیاری
نوعstring
پیش‌فرضlatest
نسخه مدلی که باید استفاده شود.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "blackforestlabs/flux-3/edit-image",
  "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": 48,
    "usd": "0.048",
    "charged": 48,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "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}تصویر تولیدشده توسط مدل.

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

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