flux-dev API

المواصفات التقنية لـ flux-dev

ما هو flux-dev؟

flux-dev هو معرّف النموذج الخاص بـ CometAPI لإصدار FLUX.1 [dev]، وهو نموذج تحويل النص إلى صورة من Black Forest Labs مُصمَّم لتوليد صور مفصّلة ووفية للمطالبة انطلاقًا من الأوصاف المكتوبة. تصف Black Forest Labs نموذج FLUX.1 [dev] بأنه مُحوِّل تدفق مُصحّح بعدد 12 مليار مُعامل، وتضعه كنموذج عالي الجودة يأتي بعد FLUX.1 [pro] ضمن تشكيلة FLUX.1 الأصلية.

عمليًا، يُستخدَم flux-dev عندما ترغب في جودة صور أقوى والتزام أفضل بالمطالبة مقارنة بالمولّدات الخفيفة، مع الاستفادة في الوقت نفسه من منظومة FLUX الأوسع. يُعرَف النموذج على نطاق واسع بإنتاج مخرجات مصقولة، والتعامل الجيد مع التوجيهات الأسلوبية، ودعم أبحاث وسير العمل الإبداعي عبر إتاحة النموذج المفتوحة على المنصات الرئيسية.

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

الميزات الرئيسية لـ flux-dev

• توليد صور عالية الجودة: تضعه Black Forest Labs كنموذج متقدّم لتحويل النص إلى صورة بجودة مخرجات أدنى بقليل من FLUX.1 [pro]، ما يجعله مناسبًا لفن المفاهيم الاحترافي، والرسوم التوضيحية، والمواد البصرية التسويقية، والنمذجة الإبداعية الأولية.
• التزام قوي بالمطالبة: يُذكر النموذج تحديدًا بقدرة تنافسية على اتباع المطالبات، وهو ما يفيد عندما تتضمن المطالبات عدة كائنات أو إشارات تخطيطية أو توجيهات أسلوبية أو أوصافًا تفصيلية للمشاهد.
• بنية مُحوِّل تدفق مُصحّح بعدد 12 مليار مُعامل: يُعد تصميمه بعدد 12 مليار مُعامل جزءًا أساسيًا من ملف قدراته وأحد أسباب ارتباطه بجودة عالية ودقة تفاصيل الصورة.
• كفاءة مُحسّنة بتقنية تقطير التوجيه: تفيد Black Forest Labs بأن FLUX.1 [dev] دُرّب باستخدام تقطير التوجيه، ما يحسّن الكفاءة مقارنة بنُهج التوليد الأقل تحسينًا.
• التوافق مع منظومة مفتوحة: تم إصدار النموذج بصيغ تدعم التجربة الأوسع، والنشر، وتخصيص سير العمل، بما في ذلك دعم المنظومة عبر Hugging Face، وتصديرات ONNX، وأدوات FLUX ذات الصلة.
• دعم مرن لسير العمل الإبداعي: flux-dev ملائم لتوليد الأفكار، والرسم البصري الأولي، واستكشاف الأساليب، ودمج الخط في الأنابيب حيث يرغب المطوّرون في نموذج نص-إلى-صورة عام قوي بدلًا من مولّد متخصّص بصورة ضيقة. هذا استنتاج استنادًا إلى التموضع الرسمي وصيغ النشر المتاحة.

كيفية الوصول إلى ودمج flux-dev

الخطوة 1: التسجيل للحصول على مفتاح API

للوصول إلى flux-dev، سجّل أولًا في CometAPI وأنشئ مفتاح API من لوحة التحكم. بعد تسجيل الدخول، أنشئ مفتاحًا لتطبيقك وخزّنه بأمان في متغير بيئي أو مدير أسرار. ستستخدم هذا المفتاح لمصادقة كل طلب إلى واجهة برمجة تطبيقات flux-dev.

الخطوة 2: إرسال الطلبات إلى واجهة برمجة تطبيقات flux-dev

بعد الحصول على مفتاح API، أرسل الطلبات إلى نقطة نهاية CometAPI مع استخدام flux-dev كاسم النموذج.

curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header "Authorization: Bearer $COMETAPI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "flux-dev",
    "prompt": "A cinematic sci-fi city at sunset, ultra-detailed, volumetric lighting"
  }'

مثال Python:

import os
import requests

url = "https://api.cometapi.com/v1/images/generations"
headers = {
    "Authorization": f"Bearer {os.environ['COMETAPI_API_KEY']}",
    "Content-Type": "application/json",
}
payload = {
    "model": "flux-dev",
    "prompt": "A cinematic sci-fi city at sunset, ultra-detailed, volumetric lighting",
}

response = requests.post(url, headers=headers, json=payload, timeout=120)
response.raise_for_status()
print(response.json())

الخطوة 3: استرجاع النتائج والتحقق منها

بعد الإرسال، تُرجع CometAPI حمولة النتائج المولّدة الخاصة بـ flux-dev. قم بتحليل الاستجابة لاستخراج روابط الصور، وبيانات الملفات، أو البيانات الوصفية ذات الصلة بحسب نمط تكاملك. ينبغي بعد ذلك التحقق من تطابق المخرجات مع المطالبة، وفحص الأمان على مستوى التطبيق أو الالتزام بالسياسات، وتسجيل معرّفات الطلب أو بيانات الاستجابة الوصفية لأغراض التصحيح، والتدقيق، وموثوقية سير العمل。