Black Forest Labs: FLUX.2 Klein 4B

FLUX.2 [klein] 4B نموذج الصور المدمج من Black Forest Labs، المقطَّر من حيث عدد الخطوات، للإنشاء من النص والتحرير بما يصل إلى أربعة مراجع. يدعم تصميمه ذو الأربع خطوات العمل البصري التفاعلي، مع احتفاظه بهوية مستقلة عن إصدار Base 4B غير المقطَّر.

Ailoot Ultra · الصور POST /v1/images/generations black-forest-labs/flux.2-klein-4b

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

FLUX.2 [klein] 4B نموذج Black Forest Labs المدمج لإنشاء صورة من وصف نصي وتحرير الصور بمراجع بصرية. يجمع محوِّله ذو التدفق المصحَّح وأربعة مليارات معلمة التوليد والتحرير في بنية واحدة. والإصدار المسمّى 4B مقطَّر من حيث عدد الخطوات، ويستخدم المثال المرجعي لدى الجهة المصنّعة أربع خطوات استدلال.

دور النموذج مسودة بصرية تفاعلية أو تعديل: استكشاف مشهد منتج أو تغيير ملابس شخصية أو دمج عنصر مع مكان أو تنقيح مظهر رسم توضيحي. ابدأ بالحدث أو التكوين المهم، ثم صِف العنصر والمادة والإضاءة وزاوية الرؤية. ويمكن لتوجيه محدّد وضع كوب خزفي أزرق مطفأ على طاولة من البلوط الفاتح، بمنظر قريب مضاء جانبيًا يحافظ على ظهور المقبض والطلاء الخزفي. والناتج صورة تُفحص مقابل هذه القرارات.

التحرير بمجموعة مراجع صغيرة

يقبل ملف 4B الموثّق ما يصل إلى أربع صور مدخلة. عيّن لكل منها دورًا واضحًا: مظهر المنتج أو الشخصية أو المكان أو الأسلوب. وإذا كانت إحدى الصور هي المشهد المطلوب تحريره، فحدّدها واذكر التغيير والتفاصيل المطلوب إبقاؤها. فمثلًا، حافظ على شكل الكوب الخارجي وسطحه من الصورة الأولى، واستخدم الغرفة من الثانية، واستبدل غطاء الطاولة فقط. يمنح ترتيب المراجع وتعليمات التغيير الدقيقة التعديل هدفًا أوضح من طلب تحسين عام.

تميّز الجهة المصنّعة ميزانية المراجع المدمجة هذه عن نسخ FLUX.2 الأكبر. وتذكر أيضًا أن [klein] لا يوسّع التوجيه. قدّم المعلومات الوصفية المهمة بنفسك، بما فيها العلاقة بين الأجسام المرجعية، بدلًا من الاعتماد على توسيع تلقائي لتسمية قصيرة. ولسلسلة صور، احتفظ بمرجع العنصر نفسه والمتطلبات البصرية مع تغيير قرار واحد في المشهد كل مرة.

إعدادات المخرجات وحدود الإصدارات

يسرد ملف 4B المحدّد لدى المنتج مخرجات JPEG وPNG وWebP، مع JPEG افتراضيًا. وتُوثَّق قيم العرض والارتفاع الصريحة بحد أدنى 64 بكسل لكل منهما؛ ويستخدم مثال بطاقة النموذج المرجعي صورة 1024×1024. وهذا المثال إعداد لأخذ العينات، وليس تأكيدًا على ضرورة أن تكون كل مهمة مربعة أو أن 1024 بكسل هو الحد الأقصى للنموذج. اختر الاقتصاص وشكل العرض المقصودين قبل تجهيز التوجيه البصري، ثم قارن الحروف الدقيقة والسمات الصغيرة بهذا الحجم.

يستخدم المثال المنشور ذو الأربع خطوات guidance_scale 1.0. أبقِ هذا الإصدار المقطَّر منفصلًا عن FLUX.2 [klein] Base 4B، الذي تستهدف إشارة تدريبه غير المقطّرة التكييف وتدريب LoRA والبحث. وBase 4B ونماذج 9B خيارات مستقلة، باعتبارات مختلفة للإعداد وأخذ العينات. كما تختلف عناصر التحكّم القياسية في النموذج المدمج عن خطوات [flex] وقوة توجيهه القابلتين للضبط؛ ول[max] قدرته الخاصة للبحث المسنَد بالمعلومات.

تفاصيل ينبغي التحقّق منها في الصورة

تنص بطاقة النموذج المحدّدة على أن هذا النموذج ليس مصدرًا للمعلومات الواقعية. وقد يكون النص المكتوب داخل صورة غير دقيق أو مشوّهًا، وقد يبتعد المشهد المولَّد عن الطلب. ولأسلوب التوجيه تأثير كبير في الالتزام. تحقّق من الإملاء والكميات والملصقات وهوية العنصر والأجسام المحدّدة المطلوب إبقاؤها؛ فالتكوين الجذاب لا يثبت صحة سمة منتج أو حقيقة مصوَّرة. وتذكر الجهة المطوّرة أيضًا أن المخرجات الإحصائية قد تعكس تحيّزات بيانات التدريب.

ولصورة خضعت للمراجعة، احتفظ بالمراجع المصدرية والصياغة النهائية وهوية النموذج المختار مع الصورة. وتميّز وثائق الإصدار بين وضع العلامة المائية على مستوى البكسل في الشيفرة المرجعية كمثال، وبين بيانات منشأ C2PA المطبّقة في مسار المخرجات المستضاف لدى الجهة المصنّعة. يساعد الاحتفاظ ببيانات المنشأ الناتجة في توضيح أصل الصورة؛ وهو أمر منفصل عن التحقّق من نجاح التغيير البصري المطلوب.

Ailoot Ultra · الصور POST /v1/images/generations black-forest-labs/flux.2-klein-4b

black-forest-labs/flux.2-klein-4b

Black Forest Labs /black-forest-labs/flux.2-klein-4b

البداية

المدخلات المقبولة: النص · الصور
النتائج: الصور

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · الصور POST /v1/images/generations

الإدخال: text, image
الإخراج: image

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود black-forest-labs/flux.2-klein-4b	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`aspect_ratio`	النوع`string`	المتطلباختياري	القيم والحدود 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	القيمة الافتراضية—
الحقل`output_format`	النوع`string`	المتطلباختياري	القيم والحدود png, jpeg	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦1⁩	القيمة الافتراضية—
الحقل`input_references`	النوع`array`	المتطلباختياري	القيم والحدود الحد الأدنى للعناصر: ⁦0⁩ الحد الأقصى للعناصر: ⁦4⁩	القيمة الافتراضية—
الحقل`provider`	النوع`object`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, prompt
المعلمة`material_types`	المواصفاتtext, image

دورة الحياة: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · قيمة task_id الفعلية المُعادة أو سجل مكتبة الوسائط

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

الباقات

كيفية احتساب الرسوم النهائية

تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع: غير محدد عند اختيار الوضع السريع
الوضع المرن: غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعدادات	جدول التعرفة	الكمية المتوقعة	وحدة الفوترة	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	الكمية المتوقعة—	وحدة الفوترة—	الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتميغابكسل من الصورة الناتجة	جدول التعرفة—	الكمية المتوقعة—	وحدة الفوترةلكل ميغابكسل من صورة الإخراج	الرسوم الإخراج · ميغابكسل من الصورة الناتجة · تقدير للمقارنة فقط $0.028 لكل ميغابكسل من صورة الإخراج
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.028 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · الصور

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-klein-4b', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

استلام النتائج وحفظها

Ailoot Ultra · الصور

نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

عمليات أخرى لقراءة المحتوى

قراءة الأصول الموجودة المملوكة لك

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

الاحتفاظ بكل النتائج المكتملة

احفظ كل صورة مكتملة؛ نزّلها من كل URL مُرجع، أو فك ترميز محتواها بصيغة Base64.

احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بقيمة X-Client-Request-ID المُعادة للمطابقة. اقرأ فقط قيم task_id/asset_id الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا.

حقول الاستجابة

الحقل	النوع
الحقل`created`	النوع
الحقل`data[].url`	النوع
الحقل`data[].b64_json`	النوع
الحقل`usage`	النوع

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra black-forest-labs/flux.2-klein-4b

الأسماء البديلة لمسارات الطرائق

/v1/images

معرّفات النماذج ذات الصلة IDs

black-forest-labs/flux.2-klein-4b

FAQ · Black Forest Labs: FLUX.2 Klein 4B

ما المدخلات والنتائج المتاحة؟: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: text, image → image
ما الحقول التي يستخدمها الطلب؟: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: model, prompt, aspect_ratio, output_format, n, input_references, provider
ما الحدود المطبقة؟: POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Klein 4B