تخطّي إلى المحتوى

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"

ملفات مثل المثال: ⁨‏0.009 $⁩ 9 أرصدة API · ≈ ⁨‏0.97 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح 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

تنسيق ملف الصورة الناتجة.

بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.

تخطيط اختياري للعناصر للاحتفاظ بعناصر المراجع أو نقلها أو تغيير حجمها أو إزالتها، أو وضع عناصر جديدة. تبدأ الإحداثيات عند (0, 0) في الزاوية العلوية اليسرى لكل صورة؛ وأشر إلى المربعات باستخدام تسميات في الموجّه، مثل `<dragon>`.

POST /run/blackforestlabs/flux-3/klein/edit-image?wait=20 عرض السعر → ⁨‏0.009 $⁩
# 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
بذرة لصور قابلة لإعادة الإنتاج: ينتج الموجّه والبذرة المتطابقان الصورة نفسها عند عدم تغيير إصدار النموذج.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب توليده.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
تنشيط مدقق السلامة؛ تُمكّن true الفحص.
output_formatاختياري
النوعenum
الافتراضيpng
jpegpngwebp
تنسيق ملف الصورة الناتجة.
image_urlsمطلوب images
النوعurl[] · image
≤ 10 عناصر
الصور المرجعية المستخدمة للتحرير أو التركيب، بحد أقصى 10.
image_sizeاختياري
النوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
تكون أبعاد المخرج افتراضياً أبعاد المرجع الأول، مع حد أقصى 1 ميغابكسل للمراجع المتعددة أو تحجيم إلى 4 ميغابكسل كحد أقصى للمرجع المنفرد. يجب أن يتراوح كل بُعد صريح بين 256 و4096 بكسل.
bounding_boxesاختياري
النوعobject[]
≤ 32 عنصرًا
تخطيط اختياري للعناصر للاحتفاظ بعناصر المراجع أو نقلها أو تغيير حجمها أو إزالتها، أو وضع عناصر جديدة. تبدأ الإحداثيات عند (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` ويستخدم سلوك الموضع نفسه مثل تحويل النص إلى صورة.
bounding_boxes[].box.x_minمطلوب
النوعnumber
0 – 1
الحد الأيسر معبراً عنه نسبةً إلى عرض الصورة، من 0 إلى 1.
bounding_boxes[].box.y_minمطلوب
النوعnumber
0 – 1
الحد العلوي معبراً عنه نسبةً إلى ارتفاع الصورة، من 0 إلى 1.
bounding_boxes[].box.x_maxمطلوب
النوعnumber
0 – 1
الحد الأيمن معبراً عنه نسبةً إلى عرض الصورة، من 0 إلى 1.
bounding_boxes[].box.y_maxمطلوب
النوعnumber
0 – 1
الحد السفلي معبراً عنه نسبةً إلى ارتفاع الصورة، من 0 إلى 1.
bounding_boxes[].source_image_indexاختياري
النوعinteger | null
≥ 0
اختيار مصدر العنصر: احذفه لعنصر جديد، أو حدد مرجعاً موجوداً بفهرسه في `image_urls`، بدءاً من 0.
bounding_boxes[].source_boxاختياري
النوعobject
موضع العنصر داخل الصورة المرجعية؛ يجب أيضاً تقديم `source_image_index`.
bounding_boxes[].source_box.x_minمطلوب
النوعnumber
0 – 1
الحد الأيسر معبراً عنه نسبةً إلى عرض الصورة، من 0 إلى 1.
bounding_boxes[].source_box.y_minمطلوب
النوعnumber
0 – 1
الحد العلوي معبراً عنه نسبةً إلى ارتفاع الصورة، من 0 إلى 1.
bounding_boxes[].source_box.x_maxمطلوب
النوعnumber
0 – 1
الحد الأيمن معبراً عنه نسبةً إلى عرض الصورة، من 0 إلى 1.
bounding_boxes[].source_box.y_maxمطلوب
النوعnumber
0 – 1
الحد السفلي معبراً عنه نسبةً إلى ارتفاع الصورة، من 0 إلى 1.
bounding_boxes[].target_boxاختياري
النوعobject
مربع موضع إخراج العنصر: يتطلب النقل أو تغيير الحجم كلا المربعين، بينما تتطلب إزالة عنصر مرجعي ترك هذا المربع دون ضبط.
bounding_boxes[].target_box.x_minمطلوب
النوعnumber
0 – 1
الحد الأيسر معبراً عنه نسبةً إلى عرض الصورة، من 0 إلى 1.
bounding_boxes[].target_box.y_minمطلوب
النوعnumber
0 – 1
الحد العلوي معبراً عنه نسبةً إلى ارتفاع الصورة، من 0 إلى 1.
bounding_boxes[].target_box.x_maxمطلوب
النوعnumber
0 – 1
الحد الأيمن معبراً عنه نسبةً إلى عرض الصورة، من 0 إلى 1.
bounding_boxes[].target_box.y_maxمطلوب
النوعnumber
0 – 1
الحد السفلي معبراً عنه نسبةً إلى ارتفاع الصورة، من 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?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
integerبذرة توليد الصورة الأولى.
has_nsfw_concepts
array of booleanيشير إلى ما إذا كانت مفاهيم NSFW تظهر في الصور المُولّدة.
prompt
stringالموجّه المستخدم أثناء توليد الصورة.

مزيد من النماذج: تحرير الصور

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/blackforestlabs/flux-3/klein/edit-image.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt