كيفية استخدام واجهة برمجة تطبيقات Flux.2؟ كل ما تحتاج إلى معرفته

FLUX.2 هي الجيل الثاني من عائلة نماذج توليد الصور وتحريرها لدى Black Forest Labs (أُطلقت في 25 نوفمبر 2025). تقدّم مستوى واقعية فوتوغرافية مناسباً للإنتاج، وتحريكاً/تحريراً متعدد المراجع حتى 4MP، وتوجيهات مُهيكلة/JSON، مع خيارات لواجهات مُدارة (Pro وFlex) وخيارات بأوزان مفتوحة (Dev).

الخبر السار هو أن CometAPI قد دمجت واجهة Flux.2 API. يشرح هذا الدليل ما هو FLUX.2، وكيفية استدعاء الواجهة البرمجية، ومسارات العمل المتقدمة (نص→صورة، تحكّم مرن، تحرير متعدد المراجع)، مع أمثلة على الشيفرة وأفضل الممارسات.

ما هو FLUX.2 ولماذا يهم؟

FLUX.2 هو المتابع لعائلة نماذج FLUX — مُصمَّم لتوليد صور عالية الدقة من النص وتحرير صور متعدد المراجع بدقّات إنتاجية (حتى ~4 ميغابكسل). تم بناء FLUX.2 لعمليات العمل الإبداعية الفعلية (أصول آمنة للعلامة التجارية، وشخصيات وأنماط متسقة عبر المراجع، وطباعية أفضل وتفاصيل صغيرة)، وليس مجرد عروض تجريبية، ويهدف إلى تقليص الفجوة بين الصور المُولَّدة والواقعية.

النتائج الأساسية التي صُمِّم FLUX.2 لتحقيقها

مخرجات فوتوغرافية مناسبة للإعلانات وصور المنتجات ونماذج واجهات المستخدم.
تحرير متعدد المراجع أصيل: دمج أو استبدال أو تركيب عناصر من عدة صور إدخال في تعديل واحد.
متغيرات لحالات استخدام مختلفة: نماذج مطوّرين متاحة علناً، وواجهة Pro محسّنة للإنتاج، وواجهة Flex للتحكّم منخفض المستوى.

على مستوى عالٍ، يجمع FLUX.2 بين عمود فقري توليدي كامن (معمارية تدفّق/محوّل) ونموذج رؤية–لغة للتأصيل الدلالي، وVAE مُدرَّب حديثاً لتوفير فضاء كامن مشترك عبر المتغيرات. يتيح هذا التصميم للنموذج كلاً من التوليد وإعادة البناء (التحرير) بموثوقية أعلى مع إبقاء التمثيل قابلاً للتعلّم للتدريب والضبط الدقيق. ويُعد الـ VAE المفتوح لافتاً بشكل خاص لأنه يوحّد الفضاء الكامن لعمليات الاستضافة والسير الذاتية (self-hosted).

لماذا يهم ذلك: إن إقران اللغة مع مطابقة التدفق الكامن يعزّز الالتزام بالمطالبات (فتتصرف التعليمات المركبة متعددة الأجزاء بشكل متوقّع)، ويحسّن الطباعة، ويوفّر بنية واحدة تدعم التوليد والتحرير مع مراجع متعددة. يعني ذلك للمبدعين مخرجات أكثر موثوقية للتعليمات المعقدة والمدخلات المختلطة (نص + صور).

كيف أصل إلى واجهة FLUX.2 API؟

تجهيز البيئة

سجّل دخولك إلى CometAPI واحصل على مفتاح API من لوحة الملف الشخصي. من الأفضل أن تمتلك بعض المعرفة بواجهات البرمجة كمطوّر (سنقدّم المساعدة في هذا الصدد، لذا لا تقلق).

ستحتاج أيضاً إلى اختيار طريقة الطلب المرغوبة وطراز Flux.2 المناسب.

ما هي نقاط النهاية ومتطلبات المصادقة؟

توفّر واجهة Replicate Predictions API إمكانية توليد صور عالية الجودة باستخدام نماذج FLUX المختلفة من Black Forest Labs عبر تنسيق Replicate القياسي. تدعم هذه الواجهة مجموعة شاملة من متغيرات نماذج FLUX، كل منها محسن لحالات استخدام متنوّعة من النمذجة السريعة إلى توليد صور احترافية. يمكن للمستخدمين التبديل بسلاسة بين النماذج المختلفة بمجرد تغيير اسم النموذج في مسار الرابط https://api.cometapi.com/replicate/v1/models/{models}/predictions، مما يجعلها مرنة للتطبيقات الإبداعية والتجارية.

CometAPI توفّر واجهات مُدارة تحت https://api.cometapi.com/flux/v1/{model} وتسمّي نقاط النهاية مثل flux-2-pro وflux-2-flex وflux-2-flex لإنشاء الصور وتحريرها. تتطلّب الطلبات مفتاح API في ترويسة x-key.

عائلة النماذج ومفاضلات الحوسبة

FLUX.2 (أوزان مفتوحة) — استخدمه عندما تحتاج إلى تحكّم محلي، أو تجارب بحثية، أو تشغيل الاستدلال على بنيتك التحتية. Dev هو وزن مفتوح (32B) وممتاز للأبحاث الاستكشافية والضبط الدقيق. إنه أكثر قابلية للتهيئة، لكنك مسؤول عن البنية والتحسين.
FLUX.2 pro — أفضل توازن بين السرعة والجودة والتكلفة للإنتاج. تم ضبط Pro لزمن استجابة متوقّع، والتزام ثابت بالمطالبات، وإنتاجية سريعة، ويدعم حتى 8 صور مرجعية عبر API (إجمالي 9MP عبر الواجهة). استخدمه للتحرير عالي الحجم وعندما تحتاج إلى موثوقية وتسعير متوقّع.
FLUX.2 (مدار + قابلية التحكّم) — يوفّر عناصر تحكّم منخفضة المستوى في التوليد (مثل steps وguidance) ويدعم مراجع أكثر (حتى 10) وجودة/تفاصيل أعلى قليلاً عند قبول زمن استجابة وتكلفة أعلى. استخدم Flex عندما تحتاج إلى التحكّم الإبداعي النهائي — دقة الطباعة، الألوان الدقيقة، أو تعديلات تركيبية عالية التفصيل.

ابدأ النمذجة على Dev أو خطة Pro منخفضة التكلفة، ثم انقل العمل إلى Pro للتوسّع أو Flex للحصول على إبداعات نهائية عالية التحكّم.

كيف أستخدم واجهة FLUX.2 API؟

دورة حياة الطلب (مهمة + الاستطلاع)

تكون الاستجابات لطلبات التحرير/التوليد عبارة عن كائنات مهام تتضمن polling_url وid؛ تنشئ طلباً ثم تستطلع (أو تستخدم webhooks) لاسترداد رابط النتيجة الموقّع. الروابط الموقّعة قصيرة العمر (عادة ~10 دقائق) لذا قم بجلب المخرجات بسرعة.

تتبع الواجهة المُستضافة نموذج مهام غير متزامن:

إرسال طلب توليد عبر POST → يعيد task id وpolling_url بالإضافة إلى cost المُقدّرة.
استطلع polling_url حتى status == "Ready"، ثم استرد صورة النتيجة (غالباً base64 أو رابط مُستضاف).

مثال: Python (requests) — إرسال واستطلاع

import time, requests, os

API_KEY = os.environ
API_URL = "https://api.cometapi.com/flux/v1/flux-2-pro"

payload = {
    "prompt": "A high-end product photo of a ceramic mug on a wooden desk, soft window light.",
    "width": 1024, "height": 1024, "seed": 42
}

r = requests.post(API_URL, headers={"x-key": API_KEY, "accept":"application/json"}, json=payload)
r.raise_for_status()
task = r.json()
polling_url = task

while True:
    time.sleep(0.5)
    status_r = requests.get(polling_url, headers={"x-key": API_KEY})
    status_r.raise_for_status()
    status = status_r.json()
    if status == "Ready":
        print("Result URL:", status)
        break
    elif status in ("Error", "Failed"):
        print("Generation failed:", status)
        break

هذا النمط (إرسال → استطلاع أو webhook) هو التدفق المتزامن/غير المتزامن الأساسي للواجهات المُدارة.

تحرير الصور — مثال بسيط (curl مع رابط إدخال)

curl -X POST "https://api.cometapi.com/flux/v1/flux-2-pro" \
  -H "accept: application/json" \
  -H "x-key: $CometAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Replace the background with a sunlit seaside boardwalk, keep the person intact and match lighting",
    "input_image": "![image](https://example.com/my-photo.jpg)",
    "width": 2048,
    "height": 1536
  }'

لأجل التحرير متعدد المراجع، استخدم input_image وinput_image_2 وinput_image_3 … (يدعم Pro حتى 8 مراجع عبر الواجهة؛ وFlex حتى 10؛ ويوصى في Dev بحد أقصى ~6 وفقاً للذاكرة).

ما هي المعلمات الأساسية التي ينبغي إرسالها؟

حقول جسم الطلب المهمة (تحرير الصور/توليدها) تشمل:

guidance وsteps — تسمح بضبط دقيق.
prompt (string) — حتى 32K رموز؛ لغة طبيعية مفصّلة أو JSON مُهيكل.
input_image (string) — مطلوب للتحرير (رابط أو base64).
input_image_2 … input_image_9 — صور متعددة كمراجع.
width / height — مضاعفات 16؛ الحد الأقصى للمخرج 4MP.
seed — عدد صحيح لإعادة الإنتاج.
safety_tolerance — مستوى الإشراف/التحقق.

كيف أستفيد من FLUX.2 Pro لتوليد صور احترافية من النص؟

تم ضبط FLUX.2 Pro لمخرجات موثوقة وعالية الجودة. استخدمه عندما تحتاج إلى نتائج بمستوى العلامة التجارية، وزمن تنفيذ سريع، واتفاقيات مستوى خدمة مؤسسية.

وصفة سير العمل — صور إنتاجية

تجهيز المطالبات: احتفظ بسطر “نية” قصير زائد قسم سمات مُهيكل (الإضاءة، العدسة، المزاج، رموز ألوان hex لألوان العلامة). يدعم FLUX.2 توجيه ألوان hex للمحافظة على لوحات العلامة.
ابدأ بقيم متحفظة: steps بين 30–50 وguidance بين 6–9.0؛ زد الخطوات للتفاصيل، وارفع guidance لالتزام أشد بالمطالبة.
استخدم البذور + أخذ عينات حتمي لإعادة الإنتاج في اختبارات A/B.
استخدم واجهة Pro لأخذ عينات متعددة المحاولات: اطلب N تنويعات بالتوازي واختر الأفضل — أرخص وأسرع من ضبط مفرط للمعلمات يدوياً.
معالجة لاحقة: إزالة ضوضاء، تخطيط نغمي طفيف، أو لمسات بأسلوب متّجه. فكّر بتمرير GAN صغير أو ترقية دقة فائقة إذا احتجت أعلى من المخرج الأصلي.

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

أفضل النصائح لتوليد الصور

1. التوجيه المُنظم يربح في الإنتاج. نظّم المطالبات حسب الأولوية: الموضوع → الفعل → الأسلوب → السياق. استخدم التوجيه بـ JSON (scene, subjects, camera, lighting, color_palette) عندما تحتاج إلى تركيب حتمي عبر العديد من الصور. مثال لاستخدام مخطط JSON (تصوّري):

{
  "scene": "product shot",
  "subjects": [
    {"type":"mug","pose":"center","style":"ceramic, matte"},
    {"type":"background","style":"wooden desk, window light"}
  ],
  "camera": {"focal_length":"85mm","aperture":"f2.8","angle":"slightly above"}
}

2. قابلية إعادة الإنتاج: مرّر seed لإعادة التوليد لاحقاً. احتفظ بفهرس يربط المطالبة + البذرة → الصورة لأغراض التتبع.

3. الدُفعات والتنظيم: للإنتاج واسع النطاق، أرسل العديد من الطلبات بالتوازي إلى Pro، ولكن حدّد المعدّل لتجنّب الخنق؛ فضّل واجهة Pro لزمن استجابة متوقّع. استخدم طوابير مهام ومجموعات عمّال لتنزيل الروابط الموقّعة بسرعة عند جاهزيتها.

4. الإشراف والسلامة: استخدم safety_tolerance للتحكّم بصرامة الإشراف. تتضمن واجهات Pro سياسات استخدام وخطافات إشراف على المحتوى؛ ادمج عمليات تحقق على الخادم قبل النشر.

5. المعالجة اللاحقة: تكون مخرجات Pro عالية الجودة لكنها قد تحتاج في بعض الأحيان رتوشاً بسيطة. ابنِ خطوة معالجة لاحقة آلية (قصّ، تصنيف لوني، تركيب) في خطّ الأنابيب واحتفظ بالمراجعة البشرية للأصول الحساسة للعلامة.

كيف أخصّص المخرجات مع واجهة FLUX.2 Flex؟

Flex هو “الأداة الجراحية”: اضبط steps وguidance والمطالبات السلبية والقرم (tile) وأعداد المراجع لتشكيل المخرجات بدقّة.

متى تختار Flex

تحتاج إلى عرض طباعي دقيق (نماذج واجهات، ملصقات).
يجب عليك تركيب مراجع متعددة مع التحكّم بالوضعية والإضاءة.
تُجرّب تقنيات مطالبات متقدمة (مطالبات مُهيكلة، سلاسل قيود).

مثال — مفاتيح تحكّم Flex وتأثيراتها

steps — المزيد من الخطوات = تفاصيل أدق (على حساب زمن الاستجابة).
guidance_scale — أعلى = التزام أكبر بالمطالبة النصية، أقل = إبداع أكثر.
negative_prompt — إزالة عناصر صراحةً (مثال: “no watermark, no extra fingers”).
tile_size / tiled_inference — لتوليد بدقة عالية جداً، جزّئ فضاء الاستدلال لموازنة الذاكرة والسرعة.
reference_weights — تسمح بعض النقاط بوزن المراجع لتحييز أي صورة تقود الوضعية مقابل الأسلوب.

نصيحة عملية: للتراكيب المعقدة، نفّذ معاينة قصيرة وبـ guidance منخفض للتحقق من التركيب، ثم قم بالترقية بمزيد من الخطوات وguidance أعلى. يقلّل نهج التمريرين هذا التكلفة ويمنح مخرجات نهائية دقيقة.

مثال: طلب Flex مع steps وguidance

curl -X POST "https://api.bfl.ai/v1/flux-2-flex" \
  -H "Content-Type: application/json" \
  -H "x-key: $BFL_API_KEY" \
  -d '{
    "prompt": "Cinematic movie poster, bold typography at top, main character centered, dramatic rim lighting",
    "width": 1536, "height": 2048,
    "steps": 50,
    "guidance": 7.5,
    "seed": 99999
  }'

نصيحة: استخدم Flex أثناء الموافقات الإبداعية النهائية، وPro لخطوط الإنتاج واسعة النطاق والأسرع. يتميّز Flex بقابلية تحكّم ملحوظة للطباعة والمهام ذات التفاصيل الدقيقة.

أفضل الممارسات للاستخدام الإنتاجي

فيما يلي أنماط مجرّبة ونصائح عملية لدمج FLUX.2 على نطاق واسع.

1) التحكّم بالتكلفة عبر تتبّع الميغابكسل والتخزين الوسيط

يُحتسب FLUX.2 وفق الميغابكسل من المدخل + المخرج. للتوليد عالي الحجم، فضّل عروض المعاينة الأصغر (دقة منخفضة وخطوات سريعة) ولا تصعّد إلا إلى مخرجات نهائية أعلى ميغابكسل. خزّن الأصول المُولّدة مؤقّتاً (أو احفظ الفروقات) كي لا تعيد توليد المهام المتطابقة. اعرض دائماً cost في الاستجابات وسجّلها لكل طلب.

2) استخدم الطبقات بذكاء: تقسيم المعاينة مقابل الإخراج النهائي

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

3) هندسة المطالبات → المطالبات المُهيكلة وJSON

استفد من التوجيه بـ JSON المُهيكل في FLUX.2 عندما تحتاج تركيباً حتمياً (كائنات المشهد، الكاميرا، الوضعيات، عينات ألوان hex). يقلّل ذلك دورات التجريب بالمطالبة ويؤدي إلى دفعات أكثر قابلية للتكرار. تُظهر أمثلة Cloudflare مطالبات JSON مضمّنة في نماذج متعددة الأجزاء.

4) البذرة + الإصدار لإعادة الإنتاج

عندما تحتاج نتائج قابلة للإعادة، مرّر seed وسجّل نسخة النموذج/الطابع الزمني في البيانات الوصفية. لخطوط أصول حتمية، احتفظ ببيان (manifest): المطالبة، البذرة، متغير النموذج، الدقة، تجزئات صور المراجع. يحسّن ذلك التتبع وخيارات التراجع.

الخلاصة

يستهدف FLUX.2 بشكل مباشر سدّ الفجوة بين “عرض مبهر” و“أداة إبداعية إنتاجية”. مع تحرير متعدد المراجع، ومخرجات عالية الدقة، ومجموعة واجهات مُستضافة (إضافة إلى شيفرة استدلال مفتوحة وبُنى مُكمّمة للمستهلكين)، يوفّر الكثير من الخيارات العملية: شغّله محلياً للأبحاث والتخصيص، أو استخدم واجهات Pro/Flex المُستضافة لخطوط إنتاج مستقرة.

يمكن للمطورين الوصول إلى Flux.2 Dev API، وFlux.2 Flex API وFlux.2 Pro API عبر CometAPI. للبدء، استكشف قدرات النماذج في CometAPI ضمن Playground وراجع API guide للتعليمات التفصيلية. قبل الوصول، تأكّد من تسجيل الدخول إلى CometAPI والحصول على مفتاح API. تقدّم CometAPI تسعيراً أقل بكثير من السعر الرسمي لمساعدتك على الدمج.

جاهز للبدء؟→ سجّل في CometAPI اليوم !

إن أردت مزيداً من النصائح والأدلة والأخبار حول الذكاء الاصطناعي، تابعنا على VK، وX وDiscord!