رفتن به محتوا

FLUX.3 Klein Image Editing

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

شناسه مدل blackforestlabs/flux-3/klein/edit-image
# 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/blackforestlabs/flux-3/klein/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://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۰۰۹⁩ ۹ اعتبار API · ≈ ⁨‎₽۰٫۹۷⁩ فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Black Forest Labs ویرایش تصویر #image-editing#image-to-image#reference-images#typography

ویرایشگر FLUX.3 Klein با حداکثر 10 مرجع و جای‌گذاری اختیاری اشیا با کادر محدودکننده

ساخته‌شده در Doitong

آثار عمومی ساخته‌شده با FLUX.3 Klein توسط جامعه Doitong. یک پرامپت را با یک کلیک دوباره استفاده کنید.

آثار عمومی نمایش‌داده‌شده: 9
Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lemb...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lemb...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Prompt Details Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut ...

Prompt Details Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikel...

Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi wajahnya. Ia memeluk...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

Foto sinematik hiper-realistis resolusi tinggi menampilkan seorang pria muda Indonesia dengan tub...

Foto sinematik hiper-realistis resolusi tinggi menampilkan seorang pria muda Indonesia dengan tubuh ramping dan proporsional, rambut hitam pendek agak acak, mengenakan jaket kulit hitam, celana riding fit, dan sepatu motor. Ia sedang melakukan aksi freestyle ekstrem dengan motor sport 500cc...

ساخت درخواست

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

•الزامی

شرح کاملی از تصویر موردنظر پس از ویرایش بنویسید و هر مرجع را با ترتیب آن، مانند تصویر اول یا دوم، مشخص کنید.

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

تصاویر مرجع استفاده‌شده برای ویرایش یا ترکیب، حداکثر 10 تصویر.

image_size

ابعاد خروجی به‌صورت پیش‌فرض از نخستین مرجع گرفته می‌شود؛ برای چند مرجع به 1 مگاپیکسل محدود و برای یک مرجع به حداکثر 4 مگاپیکسل مقیاس می‌شود. اندازه‌های صریح باید در هر بُعد بین 256 و 4096 پیکسل باشند.

num_images پیش‌فرض 1

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

پیشرفته output_format · seed · enable_prompt_expansion · enable_safety_checker · bounding_boxes
output_format پیش‌فرض png

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

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

چیدمان اختیاری اشیا برای نگه‌داری، جابه‌جایی، تغییر اندازه یا حذف اشیای مرجع، یا قرار دادن اشیای جدید. مختصات در هر تصویر از (0, 0) در گوشه بالا-چپ آغاز می‌شوند؛ با برچسب‌هایی مانند `<dragon>` در پرامپت به کادرها ارجاع دهید.

POST /run/blackforestlabs/flux-3/klein/edit-image?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/blackforestlabs/flux-3/klein/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://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

درباره FLUX.3 Klein Image Editing

با پرامپت و 1 تا 10 مرجع در `image_urls` تصاویر را ویرایش یا ترکیب می‌کند؛ پرامپت می‌تواند با ترتیب، مانند تصویر اول، به آن‌ها ارجاع دهد. حداکثر 32 `bounding_boxes` امکان حفظ، جابه‌جایی، تغییر اندازه، حذف یا افزودن اشیا را فراهم می‌کنند؛ نام اشیا در پرامپت با برچسب مشخص می‌شود. گسترش پرامپت به‌طور پیش‌فرض فعال است. 1 تا 4 تصویر با jpeg، png یا webp برمی‌گرداند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
شرح کاملی از تصویر موردنظر پس از ویرایش بنویسید و هر مرجع را با ترتیب آن، مانند تصویر اول یا دوم، مشخص کنید.
enable_prompt_expansionاختیاری
نوعboolean
پیش‌فرضtrue
گسترش پرامپت به شرحی جزئی پیش از تولید، در صورت true فعال می‌شود. هنگام ویرایش، شرح بر اساس تصاویر مرجع تهیه می‌شود.
seedاختیاری
نوعinteger | null
seed برای تصاویر تکرارپذیر: پرامپت و seed یکسان، در صورت ثابت‌بودن نسخه مدل، تصویر یکسانی تولید می‌کنند.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۴
تعداد تصاویر درخواستی برای تولید.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
فعال‌سازی بررسی‌کننده ایمنی؛ true بررسی را فعال می‌کند.
output_formatاختیاری
نوعenum
پیش‌فرضpng
jpegpngwebp
قالب فایل تصویر نهایی.
image_urlsالزامی images
نوعurl[] · image
≤ ۱۰ مورد
تصاویر مرجع استفاده‌شده برای ویرایش یا ترکیب، حداکثر 10 تصویر.
image_sizeاختیاری
نوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ابعاد خروجی به‌صورت پیش‌فرض از نخستین مرجع گرفته می‌شود؛ برای چند مرجع به 1 مگاپیکسل محدود و برای یک مرجع به حداکثر 4 مگاپیکسل مقیاس می‌شود. اندازه‌های صریح باید در هر بُعد بین 256 و 4096 پیکسل باشند.
bounding_boxesاختیاری
نوعobject[]
≤ ۳۲ مورد
چیدمان اختیاری اشیا برای نگه‌داری، جابه‌جایی، تغییر اندازه یا حذف اشیای مرجع، یا قرار دادن اشیای جدید. مختصات در هر تصویر از (0, 0) در گوشه بالا-چپ آغاز می‌شوند؛ با برچسب‌هایی مانند `<dragon>` در پرامپت به کادرها ارجاع دهید.
bounding_boxes[].labelاختیاری
نوعstring | null
≤ 64 characters
برچسب کوتاه شیء برای کادر، مانند `dragon`؛ مقدار پیش‌فرض `obj_<n>` است. برای مرتبط‌کردن کلمات با کادر، `<dragon>` را در پرامپت بگنجانید؛ کادرهای ذکرنشده در پرامپت به صحنه افزوده می‌شوند.
bounding_boxes[].descriptionالزامی
نوعstring
≤ 500 characters
شیئی که باید در کادر رندر شود، شامل ظاهر آن.
bounding_boxes[].boxاختیاری
نوعobject
کادر جای‌گذاری خروجی شیء که جایگزین `source_box`/`target_box` می‌شود و از همان رفتار جای‌گذاری text-to-image استفاده می‌کند.
bounding_boxes[].box.x_minالزامی
نوعnumber
۰ – ۱
مرز چپ نسبت به عرض تصویر، از 0 تا 1.
bounding_boxes[].box.y_minالزامی
نوعnumber
۰ – ۱
مرز بالا نسبت به ارتفاع تصویر، از 0 تا 1.
bounding_boxes[].box.x_maxالزامی
نوعnumber
۰ – ۱
مرز راست نسبت به عرض تصویر، از 0 تا 1.
bounding_boxes[].box.y_maxالزامی
نوعnumber
۰ – ۱
مرز پایین نسبت به ارتفاع تصویر، از 0 تا 1.
bounding_boxes[].source_image_indexاختیاری
نوعinteger | null
≥ ۰
انتخاب منبع شیء: برای شیء جدید حذف کنید، یا مرجع موجود را با اندیس آن در `image_urls` شناسایی کنید؛ شمارش از 0 آغاز می‌شود.
bounding_boxes[].source_boxاختیاری
نوعobject
موقعیت شیء در تصویر مرجع؛ `source_image_index` نیز باید ارائه شود.
bounding_boxes[].source_box.x_minالزامی
نوعnumber
۰ – ۱
مرز چپ نسبت به عرض تصویر، از 0 تا 1.
bounding_boxes[].source_box.y_minالزامی
نوعnumber
۰ – ۱
مرز بالا نسبت به ارتفاع تصویر، از 0 تا 1.
bounding_boxes[].source_box.x_maxالزامی
نوعnumber
۰ – ۱
مرز راست نسبت به عرض تصویر، از 0 تا 1.
bounding_boxes[].source_box.y_maxالزامی
نوعnumber
۰ – ۱
مرز پایین نسبت به ارتفاع تصویر، از 0 تا 1.
bounding_boxes[].target_boxاختیاری
نوعobject
کادر جای‌گذاری خروجی شیء: جابه‌جایی یا تغییر اندازه به هر دو کادر نیاز دارد، درحالی‌که برای حذف شیء مرجع باید این کادر تنظیم نشود.
bounding_boxes[].target_box.x_minالزامی
نوعnumber
۰ – ۱
مرز چپ نسبت به عرض تصویر، از 0 تا 1.
bounding_boxes[].target_box.y_minالزامی
نوعnumber
۰ – ۱
مرز بالا نسبت به ارتفاع تصویر، از 0 تا 1.
bounding_boxes[].target_box.x_maxالزامی
نوعnumber
۰ – ۱
مرز راست نسبت به عرض تصویر، از 0 تا 1.
bounding_boxes[].target_box.y_maxالزامی
نوعnumber
۰ – ۱
مرز پایین نسبت به ارتفاع تصویر، از 0 تا 1.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "blackforestlabs/flux-3/klein/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": 9,
    "usd": "0.009",
    "charged": 9,
    "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
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of object {url, content_type, file_name, file_size, width, height}تصاویر تولیدشده توسط مدل.
timings
objectاطلاعات زمان‌بندی فرایند تولید.
seed
integerseed تولید برای تصویر اول.
has_nsfw_concepts
array of booleanمشخص می‌کند مفاهیم NSFW در تصاویر تولیدشده ظاهر می‌شوند یا خیر.
prompt
stringپرامپت استفاده‌شده هنگام تولید تصویر.

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

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