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

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

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

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

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

النتائج الرئيسية تم تصميم FLUX.2 لتقديم

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

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

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

كيف يمكنني الوصول إلى واجهة برمجة التطبيقات FLUX.2؟

إعداد البيئة

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

سوف تحتاج أيضًا إلى تحديد طريقة الطلب المطلوبة ونموذج Flux.2 المناسب.

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

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

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

التنازلات بين عائلة النموذج والحوسبة

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

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

كيف أستخدم واجهة برمجة التطبيقات FLUX.2؟

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

الاستجابات لطلبات التحرير/التوليد هي كائنات المهمة التي تشمل أ polling_url و idأنشئ طلبًا، ثم استطلع (أو استخدم خطافات الويب) لاسترداد عنوان URL للنتيجة المُوقّعة. مدة عناوين URL المُوقّعة قصيرة (عادةً حوالي ١٠ دقائق)، لذا يتم جلب النتائج فورًا.

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

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

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

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

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

تحرير الصور - مثال بسيط (تجعيد مع إدخال عنوان URL)

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": "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 (سلسلة) — ما يصل إلى 32 ألف رمز؛ لغة طبيعية مفصلة أو JSON منظمة.
input_image (سلسلة) — مطلوبة للتعديلات (عنوان URL أو base64).
input_image_2 ... input_image_9 - صور متعددة المراجع.
width / height — مضاعفات 16؛ إخراج أقصى 4 ميجابكسل.
seed - عدد صحيح لإمكانية إعادة الإنتاج.
safety_tolerance - مستوى الاعتدال.

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

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

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

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

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

أفضل النصائح لإنشاء الصور

1. التوجيه المنظم يؤدي إلى الفوز في الإنتاج. نظّم المطالبات حسب الأولوية: الموضوع ← الإجراء ← الأسلوب ← السياق. استخدم مطالبات JSON (المشهد، الموضوعات، الكاميرا، الإضاءة، لوحة الألوان) عندما تحتاج إلى تكوين محدد للعديد من الصور. مثال على استخدام مخطط 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 للتحكم في صرامة الإشراف. تتضمن نقاط النهاية الاحترافية سياسات الاستخدام وأدوات الإشراف على المحتوى؛ وتُدمج عمليات التحقق من جانب الخادم قبل النشر.

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

كيف يمكنني تخصيص المخرجات باستخدام نقطة نهاية FLUX.2 Flex؟

Flex هو البديل لـ "الأداة الجراحية": خطوات الضبط، والتوجيه، والمطالبات السلبية، وأحجام البلاط، وعدد المراجع لتشكيل الناتج بدقة.

متى تختار فليكس

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

مثال - مفاتيح التحكم المرنة وتأثيراتها

steps — خطوات أكثر = تفاصيل أدق (على حساب زمن الوصول).
guidance_scale — أعلى = أقرب إلى النص المطلوب، أقل = المزيد من الإبداع.
negative_prompt - إزالة العناصر صراحةً (على سبيل المثال، "لا توجد علامة مائية، ولا أصابع إضافية").
tile_size / tiled_inference - لتوليد دقة عالية جدًا، مساحة استدلال البلاط لتداول الذاكرة مقابل السرعة.
reference_weights — تتيح لك بعض نقاط النهاية ترجيح المراجع للتحيز في الصورة التي تحدد الوضع مقابل الأسلوب.

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

مثال: طلب مرن مع الخطوات والإرشادات

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 على وحدات الميجابكسل الإدخال + الإخراجلتوليد كميات كبيرة، يُفضّل استخدام عمليات عرض معاينة أصغر (خطوات سريعة منخفضة الدقة) والتصعيد فقط إلى عمليات عرض نهائية بدقة MP أعلى. خزّن الأصول المُقدّمة مؤقتًا (أو خزّن الاختلافات) حتى لا تُعيد عرض أعمال متطابقة. احرص دائمًا على الظهور cost في الردود وتسجيلها لكل طلب.

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

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

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

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

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

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

الخاتمة

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

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

هل أنت مستعد للذهاب؟→ سجل في CometAPI اليوم !

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