Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] نموذج الصور المخصّص للإنتاج من Black Forest Labs، للإنشاء انطلاقًا من النص والتحرير الموجّه بالمراجع. يجمع ملفه الموثّق التفاصيل الواقعية والتحكّم في النص واللون، مع ميزانية بكسلات مشتركة للمراجع والمخرجات وصور حتى 4 ميغابكسل.

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

عن النموذج

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

FLUX.2 [pro] نموذج Black Forest Labs لتوليد الصور وتحريرها مع التركيز على الإنتاج. وتقدّمه الجهة المصنّعة كخيار افتراضي لمعظم المهام البصرية في FLUX.2: إنشاء صورة جديدة من نص أو تعديل مشهد باستخدام مراجع بصرية. وتشمل قدرات عائلته المواد والإضاءة الواقعية والنص المقروء وتعليمات اللون الدقيق واتساق العناصر بين التعديلات المترابطة. والناتج صورة يمكن استخدامها في مشهد منتج أو تكوين تحريري أو مفهوم تصميم أو تواصل بصري.

جهّز توجيهًا للإنتاج

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

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

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

حرّر بالمراجع وميزانية بكسلات مشتركة

يوفّر ملف طلب [pro] المحدّد ثمانية مواضع للصور المرجعية؛ بينما تدعم واجهة الجهة المطوّرة التفاعلية عشر صور بصورة مستقلة. عيّن لكل صورة دورًا مثل مظهر العنصر أو الملابس أو تصميم المنتج أو الغرفة أو الأسلوب. وفي مشهد موجود، حدّد العنصر المطلوب تغييره وما يجب أن يبقى من التكوين والمحيط والتفاصيل البصرية. وتشمل الأمثلة المنشورة تركيب الأثاث وتغيير الخلفية أو الطقس واستبدال الأجسام وتعديل النصوص.

تعتمد سعة المراجع أيضًا على حجم المخرجات. يحدّد دليل [pro] لدى المنتج ميزانية إجمالية قدرها 9 ميغابكسل للمدخلات والمخرجات معًا. وتسمح أمثلته بثمانية مراجع عند إخراج 1 ميغابكسل، وسبعة عند إخراج 2 ميغابكسل، فتقل سعة المراجع كلما كبر الناتج المطلوب. خطّط لمجموعة المصادر والمخرجات معًا، بدلًا من اعتبار الحد الأقصى للمواضع متاحًا لكل حجم إخراج. استخدم المراجع التي تثبت المعلومات الضرورية وحدّد إسهامها المقصود.

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

توسيع التوجيه والملفات الثابتة مقارنةً بPreview

تفعّل مواصفات [pro] المحدّدة توسيع التوجيه افتراضيًا. ويوقف عنصر disable_pup هذا التوسيع عندما يجب استخدام تعليمات مكتوبة بعناية كما قُدّمت. احتفظ بالإعداد المختار عند مقارنة النسخ، لأن المفهوم القصير نفسه والوصف الموسَّع مدخلان مختلفان للتوليد. وهذا عنصر تحكّم في ملف الجهة المطوّرة، وليس ضمانًا لظهور كل تفصيل مطلوب بصورة صحيحة.

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

الأبعاد والصيغ والصورة المختارة

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

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

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

black-forest-labs/flux.2-pro

Black Forest Labs /black-forest-labs/flux.2-pro

البداية

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

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

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

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

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود black-forest-labs/flux.2-pro	القيمة الافتراضية—
الحقل`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⁩ الحد الأقصى للعناصر: ⁦8⁩	القيمة الافتراضية—
الحقل`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.06 لكل ميغابكسل من صورة الإخراج
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	وحدة الفوترة—	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.06 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز 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-pro', '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-pro

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

/v1/images

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

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro