كيف تفتح حسابًا في Black Forest Labs وتنشئ بيانات اعتماد Flux API، وكم تكلّف النقاط بسعر $0.01 للنقطة، وكيف تُسعَّر FLUX.1 وFLUX.2 وFLUX 3 لكل صورة، وهل توجد نسخة مجانية، وحدود الاستخدام التي ينبغي أن تخطط لها، وطلب يعمل بلغة Python.
بحثت عن مفتاح Flux API لأنك تريد توليد الصور من خلال الشيفرة، وتريد معرفة السعر قبل أن تضيف بطاقة إلى حسابك. وهذا منطقي. تبيع Black Forest Labs نموذج Flux عبر API يعتمد على النقاط، وتتوزّع الإجابات عن الأسعار والاستخدام المجاني والحدود على عدة صفحات توثيق. يجمع هذا المقال كل ذلك في مكان واحد، استنادًا إلى التوثيق الرسمي كما اطّلعنا عليه في أكتوبر 2026.
الخلاصة المختصرة: 1 نقطة تساوي $0.01، وتدفع مقابل كل صورة (أو مقابل كل ثانية من الفيديو)، ولا يعلن التوثيق عن أي نقاط مجانية للحسابات الجديدة، والحد الأقصى الافتراضي هو 24 مهمة نشطة في الوقت نفسه. يوضح باقي هذه الصفحة كيف تنطبق هذه الحقائق عمليًا، مع جدول بكل الأسعار الحالية وطلب يمكنك تشغيله اليوم.
💡 الأسعار تتغير. كل الأرقام هنا مأخوذة من صفحة الأسعار ومركز المساعدة في Black Forest Labs. تحقّق من الصفحة المباشرة قبل أن تضع ميزانية لمهمة كبيرة، لأن نماذج جديدة ومستويات دقة جديدة تظهر بكثرة.
يبدأ كل شيء من dashboard.bfl.ai. يوجد الحساب وبيانات الاعتماد والفوترة هناك، ويستغرق الإعداد نحو خمس دقائق.
افتح لوحة التحكم، وانقر على تسجيل الدخول، وسجّل بالبريد الإلكتروني وكلمة المرور أو بحساب Google. ينشئ التسجيل تلقائيًا المؤسسة الافتراضية والمشروع الافتراضي، لذلك لا يوجد شيء إضافي للإعداد. تحتفظ المؤسسة بالفوترة ورصيد النقاط، ويحتفظ المشروع ببيانات اعتماد API. إذا قسّمت العمل لاحقًا بين عملاء أو منتجات مختلفة، يمكنك إضافة مشاريع دون فتح حساب ثانٍ.
داخل مشروعك، انتقل إلى API، ثم إلى المفاتيح، وانقر على إضافة مفتاح. أعطه اسمًا وصفيًا مثل production-images. يُعرض مفتاح API الكامل مرة واحدة فقط، لذلك انسخه مباشرة إلى مدير كلمات المرور أو إلى متغير بيئة. ثلاث عادات ستوفر عليك كثيرًا من المتاعب:
x-key مع كل طلب، تمامًا كما يفعل المثال لاحقًا في هذا المقال.
تفشل الطلبات بدون رصيد، لذلك موّل الحساب أولًا. في الشريط الجانبي انتقل إلى API، ثم إلى النقاط، وانقر على إضافة نقاط، واختر المبلغ. تتولى Stripe عملية الدفع، وتصبح النقاط متاحة فورًا. ينص التوثيق على عدم وجود حد أدنى للشراء اليدوي.
الشحن التلقائي اختياري. يجب أن تكون عتبة التشغيل $5 على الأقل، ويجب أن يكون هدف إعادة الشحن أعلى من هذه العتبة بمقدار $10 على الأقل. إذا فشل خصم تلقائي، يتوقف الشحن التلقائي عن العمل من تلقاء نفسه حتى تعيد تفعيله، لذا تحقق من بيانات بطاقتك قبل أي تشغيل طويل دون مراقبة.
تعتمد Black Forest Labs ثلاثة أساليب تسعير متوازية. تتقاضى نماذج FLUX.1 الأقدم عددًا ثابتًا من النقاط لكل صورة. أما عائلة FLUX.2 فتتقاضى حسب الميغابكسل. وتتقاضى نماذج FLUX 3 الأحدث حسب مستوى الدقة، أو حسب الثانية في حالة الفيديو. يُحتسب سعر ملعب الاختبار بالسعر نفسه المعتمد لواجهة API، لذلك فإن تجربة النموذج في المتصفح ليست حلًا بديلًا مجانيًا.
هذه أسهل الأسعار في التخطيط للميزانية، لأن الطلب الواحد يكلّف المبلغ نفسه مهما كان الحجم المدعوم.
| النموذج | النقاط | السعر لكل صورة |
|---|---|---|
| Flux 1.1 Pro | 4 | $0.04 |
| Flux 1.1 Pro Ultra (Ultra و Raw) | 6 | $0.06 |
| Flux Kontext Pro | 4 | $0.04 |
| Flux Kontext Max | 8 | $0.08 |
| Flux Fill Pro | 5 | $0.05 |
Kontext هو خط التعديل: ترسل صورة مع تعليمة نصية، فيغيّر النموذج ما تصفه. يتولى Fill Pro التعديل الموضعي وتوسيع الصورة.
تبدأ أسعار FLUX.2 منخفضة وترتفع مع الدقة: يكلّف أول ميغابكسل سعرًا ثابتًا، ويضيف كل ميغابكسل إضافي إلى الإجمالي. تمثل الأرقام أدناه أسعار البداية.
| النموذج | تحويل النص إلى صورة | تعديل الصور |
|---|---|---|
| Flux 2 Klein 4B | من $0.014 | من $0.014 |
| Flux 2 Klein 9B | من $0.015 | من $0.015 |
| Flux 2 Pro | من $0.03 | من $0.045 |
| Flux 2 Flex | من $0.05 | من $0.05 |
| Flux 2 Max | من $0.07 | من $0.07 |
| Flux 2 Dev | محلي فقط | محلي فقط |
تشكّل النسختان Klein 4B و Klein 9B الثنائي الاقتصادي، وPro هو الخيار المعتاد للإنتاج، وMax يتصدّر قائمة الأسعار. لا يملك Flux 2 Dev سعرًا في API لأن التوثيق يدرجه على أنه محلي فقط.
يقسّم FLUX 3 تسعير الصور حسب حجم الإخراج.
| مستوى الإخراج | الحجم التقريبي | السعر لكل صورة |
|---|---|---|
| 768sq | 768 x 768 بكسل | $0.041 |
| 1k | حوالي 1 ميغابكسل | $0.048 |
| 2k | حوالي 4 ميغابكسل | $0.100 |
| 4k | حوالي 16 ميغابكسل | $0.607 |
يُحتسب الفيديو بالثانية. يتراوح سعر تحويل النص إلى فيديو وتحويل الصورة إلى فيديو من $0.17 حتى $0.80 لكل ثانية للتصيير الكامل، بينما يكلّف التصيير التجريبي $0.06 لكل ثانية. لذلك يكلّف مقطع تجريبي مدته خمس ثوانٍ $0.30، ويكلّف تصيير كامل مدته خمس ثوانٍ ما لا يقل عن $0.85. يمكنك تجربة Flux 3 بوصفه نموذج تحويل نص إلى فيديو على PicassoIA قبل أن تلتزم بأسعار API الخاصة به.
الجواب المختصر: لا توجد نسخة مجانية يعلن عنها التوثيق.
تبدأ صفحة الأسعار بقاعدة واحدة: 1 نقطة تساوي $0.01 USD، وتدفع مقابل كل صورة، والسعر نفسه لواجهة API والملعب. ولا تذكر نقاطًا عند التسجيل، ولا حصة مجانية شهرية، ولا نسخة تجريبية. وصفحتا النقاط والفوترة صامتتان كذلك عن نقاط التجربة. وتصل متتبعات الأسعار المستقلة إلى الحكم نفسه، وهو أنه لا توجد نسخة مجانية تقليدية. إذا كان هناك عرض ترويجي قائم، فتحقّق من لوحة التحكم بعد التسجيل، لأنه لا يوجد أي عرض موثّق.
لذلك خطّط لإيداع أولي صغير. إيداع بقيمة $10 يشتري 1,000 نقطة. هذا يعني 250 صورة باستخدام Flux 1.1 Pro بواقع 4 نقاط لكل صورة، أو أكثر من 700 صورة باستخدام Flux 2 Klein 4B بسعر $0.014 لكل صورة.
💡 جرّب الأرخص أولًا. شغّل قوالب أوامرك النصية على أرخص نموذج قبل أن تنفق نقاطًا على Max أو Ultra. يكلّف الأمر النصي السيئ المبلغ نفسه على كل نموذج.
تتيح ثلاث طرق تجنّب الدفع إلى Black Forest Labs مقابل كل صورة:
هناك قاعدتان تشكّلان كل تكامل: عدد المهام التي يمكن تشغيلها في وقت واحد، والمدة التي لديك لالتقاط النتيجة.
حد التزامن هو عدد الطلبات التي يمكن أن يملكها الحساب قيد التنفيذ في وقت واحد. وهو افتراضيًا 24 مهمة نشطة. يحصل نموذجان على سقف أضيق: flux-kontext-max محدود بحد أقصى 6 مهام نشطة، وفيديو FLUX 3 يبدأ عند 5 مهام فيديو متزامنة. الحدود الأعلى ممكنة إذا تواصلت مع دعم Black Forest Labs.
عند تجاوز الحد، ترد API برمز HTTP 429. لا شيء يضيع: انتظر حتى تنتهي إحدى مهامك السابقة، ثم أرسل الطلب من جديد. وفي الشيفرة، يعني ذلك إشارة تزامن (semaphore) محدودة بعدد أقل قليلًا من 24، وإعادة محاولة مع تراجع متدرّج عند 429. يحسب الحد المهام التي ما زالت قيد التشغيل، لا عدد الطلبات في الثانية، لذلك يتيح لك نموذج أسرع دفع صور أكثر عبر السقف نفسه.
تحتوي استجابة أول طلب POST على id و**polling_url**. استخدم ذلك الرابط، لا رابطًا تبنيه بنفسك، خاصة على نقطة النهاية العامة api.bfl.ai أو على نقاط النهاية الإقليمية، api.eu.bfl.ai وapi.us.bfl.ai. استمر في الاستعلام حتى تصبح الحالة Ready أو Error أو Failed.
الرابط الموقّع في النتيجة الجاهزة صالح لمدة 10 دقائق فقط. نزّل الملف وانسخه إلى مساحة تخزينك الخاصة، مثل S3 أو R2، في اللحظة التي تتحول فيها الحالة إلى Ready. إذا كان العامل الخاص بك متوقفًا عند انتهاء المهمة، تنتهي صلاحية الإخراج ويتعين عليك إعادة توليد الصورة.
إليك نص برمجي بسيط بلغة Python يستخدم نقطة نهاية Flux 1.1 Pro، وتكلّف الصورة الواحدة فيه 4 نقاط ($0.04). اضبط BFL_API_KEY في متغيرات البيئة أولًا.
import os, time, requests
BASE = "https://api.bfl.ai/v1"
HEADERS = {"x-key": os.environ["BFL_API_KEY"], "accept": "application/json"}
job = requests.post(
f"{BASE}/flux-pro-1.1",
headers=HEADERS,
json={
"prompt": "A ceramic perfume bottle on a white table, soft window light",
"width": 1024,
"height": 768,
},
).json()
while True:
result = requests.get(job["polling_url"], headers=HEADERS).json()
if result["status"] == "Ready":
break
if result["status"] in ("Error", "Failed"):
raise RuntimeError(result)
time.sleep(1)
image = requests.get(result["result"]["sample"]).content
open("bottle.jpg", "wb").write(image)
يرسل النص البرمجي مهمة، ويقرأ polling_url من الرد، ويتحقق منه مرة كل ثانية، ويحفظ الصورة قبل انتهاء صلاحية الرابط الموقّع. لاستخدام نموذج آخر، غيّر مسار نقطة النهاية إلى المسار المدرج له في مرجع API على docs.bfl.ai. كما يوثّق مرجع API استدعاءً يعيد رصيدك المتبقي من النقاط، ويستحق تشغيله قبل أي دفعة كبيرة.
تتراكم الفروق الصغيرة في كل صورة لتصبح مبالغ حقيقية عند الحجم الكبير. يوضح الجدول تكلفة 1,000 صورة عند كل سعر بداية.
| النموذج | السعر لكل صورة | لكل 1,000 صورة |
|---|---|---|
| Flux 2 Klein 4B | $0.014 | $14 |
| Flux 2 Klein 9B | $0.015 | $15 |
| Flux 2 Pro | من $0.03 | $30 |
| Flux 1.1 Pro | $0.04 | $40 |
| Flux Kontext Pro | $0.04 | $40 |
| صورة FLUX 3، 1k | $0.048 | $48 |
| Flux 2 Flex | من $0.05 | $50 |
| Flux 1.1 Pro Ultra | $0.06 | $60 |
| Flux 2 Max | من $0.07 | $70 |
| Flux Kontext Max | $0.08 | $80 |
نمط معقول هو إنشاء مسودات أولية بنموذج Klein، ثم إعادة توليد الفائزين فقط على Pro أو Max. للتعديل، ابدأ بنموذج Kontext Pro وانتقل إلى Kontext Max فقط عندما تحتاج النتيجة إلى ذلك. يملك Kontext Max أيضًا أضيق حد للتزامن، لذا فهو خيار ضعيف للمهام الكبيرة.
تضرب طلبات الدفعات التكلفة الأساسية في عدد الصور، لذا فإن 200 صورة على Flux 1.1 Pro تكلّف 200 مرة $0.04، أي $8. تُحفظ النقاط على مستوى المؤسسة وتُشارك بين مشاريعها، لذلك لا تمنحك المشاريع المنفصلة ميزانيات منفصلة. فعّل الشحن التلقائي فقط بعد أن تحدد عتبة يمكنك تحمّل خسارتها بسبب حلقة تكرار خارجة عن السيطرة، وتحقق من استدعاء رصيد النقاط في بداية كل مهمة كبيرة.
إذا كنت تريد صورًا بدلًا من تكامل برمجي، يمكنك تخطّي إعداد الحساب والنقاط والشيفرة. يستضيف PicassoIA Flux 2 Pro في المتصفح، ويقبل حتى ثماني صور مرجعية إلى جانب أمرك النصي.
إليك كيفية استخدام Flux 2 Pro على PicassoIA، خطوة بخطوة:
| المعامل | الافتراضي | نصيحة |
|---|---|---|
| نسبة العرض إلى الارتفاع | 1:1 | اختر 16:9 لبانرات المدونة، أو 9:16 للقصص، أو حجمًا مخصصًا |
| الدقة | 1 MP | تصل الدقة إلى 4 MP، لكن يُوصى بدقة 2 MP أو أقل |
| صور الإدخال | لا شيء | الحد الأقصى 8، ويمكن الجمع بين مراجع الأسلوب والموضوع |
| تنسيق الإخراج | WebP | استخدم PNG عندما تحتاج ملفات بدون فقدان |
| جودة الإخراج | 80 | ارفعها للطباعة، واخفضها لصفحات أسرع تحميلًا |
| هامش الأمان | 2 | الأكثر صرامة عند 1 والأكثر تساهلًا عند 5 |
| قيمة البذرة | عشوائي | اضبطها لتكرار النتيجة بدقة |
يجب أن يكون العرض والارتفاع المخصصان من مضاعفات 32، وأكبر إخراج هو 2048 x 2048 بكسل، لذا لن تصل النسب العريضة جدًا إلى كامل 4 MP.
تُعد API الخاصة بشركة Black Forest Labs الأداة المناسبة عندما تبني منتجًا يستدعي Flux آلاف المرات. أما في كل ما عدا ذلك، فأسرع طريقة لمعرفة ما تفعله هذه النماذج هي كتابة أمر نصي والنظر إلى النتيجة.
افتح Picasso IA، واختر Flux 2 Pro أو أي نموذج من قائمة النماذج الكاملة، وولّد أول صورة لك في دقائق. جرّب الأمر النصي نفسه على نموذجين أو ثلاثة، وقارن النتائج جنبًا إلى جنب، ولاحظ أي نموذج يستحق سعره. وبمجرد أن تعرف النموذج الذي يناسب عملك، ستعرف أيضًا نقطة نهاية API التي يجب أن تخصص لها ميزانية.
اختر لغتك
