3 خطوات لإكمال ربط واجهة برمجة التطبيقات (API) لـ FLUX.2 Pro و Max: دليل عملي لأقوى نموذج لتوليد الصور من BFL

أصبحت سلسلة FLUX.2 من Black Forest Labs واحدة من أكثر نماذج توليد الصور لفتًا للانتباه في عام 2025. يمثل الوصول السريع إلى واجهات برمجة التطبيقات (API) لـ FLUX.2 Pro و FLUX.2 Max مسألة تهم الكثير من المطورين والمبدعين. سيقدم هذا المقال دليلًا كاملاً للوصول، مما يساعدك على إتمام التكامل في غضون 5 دقائق.

القيمة الجوهرية: بعد قراءة هذا المقال، ستتقن طرق استدعاء API لـ FLUX.2 Pro/Max، وتقنيات تكوين المعلمات، وستعرف كيفية اختيار إصدار النموذج المناسب لسيناريو عملك.

نظرة سريعة على المعلومات الأساسية لسلسلة FLUX.2

قبل البدء في عملية الربط، دعنا نلقي نظرة على المعلومات الأساسية لسلسلة FLUX.2:

مصفوفة نماذج FLUX.2

🎯 نصيحة للوصول: بالنسبة لمعظم سيناريوهات الإنتاج، نوصي بالوصول إلى FLUX.2 Pro عبر منصة APIYI (apiyi.com)، حيث توفر المنصة واجهة متوافقة مع OpenAI، مما يغنيك عن التعامل مع إجراءات المصادقة المعقدة لـ API الرسمي.

الاختلافات الجوهرية بين FLUX.2 Pro و Max

هل تختار FLUX.2 Pro أم Max؟ هذا هو السؤال الأكثر شيوعاً بين المطورين. يوضح الجدول التالي الاختلافات بينهما بالتفصيل:

توصيات الاختيار

اختر FLUX.2 [pro] في الحالات التالية:

• توليد صور منتجات التجارة الإلكترونية بكميات كبيرة.
• إنشاء محتوى لوسائل التواصل الاجتماعي.
• الإنتاج الضخم للمواد الإعلانية.
• المشاريع الحساسة للتكلفة.
• الحاجة إلى مخرجات مستقرة ومتسقة.

اختر FLUX.2 [max] في الحالات التالية:

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

الوصول السريع إلى FLUX.2 API

الطريقة الأولى: عبر واجهة APIYI الموحدة (موصى بها)

منصة APIYI توفر الآن طرازي FLUX.2 Pro و FLUX.2 Max، مع دعم الاستدعاء بتنسيق متوافق مع OpenAI:

import requests

# واجهة APIYI الموحدة
base_url = "https://api.apiyi.com/v1"

def generate_image_flux2(prompt, model="flux.2-pro", width=1024, height=1024):
    """
    توليد الصور عبر FLUX.2 باستخدام APIYI

    Args:
        prompt: وصف الصورة (الموجه)
        model: flux.2-pro أو flux.2-max
        width: عرض الصورة (مضاعفات 16، بحد أقصى 2048)
        height: ارتفاع الصورة (مضاعفات 16، بحد أقصى 2048)
    """
    headers = {
        "Authorization": "Bearer YOUR_APIYI_KEY",
        "Content-Type": "application/json"
    }

    data = {
        "model": model,
        "prompt": prompt,
        "size": f"{width}x{height}",
        "response_format": "url"
    }

    response = requests.post(
        f"{base_url}/images/generations",
        json=data,
        headers=headers
    )

    result = response.json()
    return result["data"][0]["url"]


# مثال على الاستخدام
image_url = generate_image_flux2(
    prompt="A professional product photo of a modern smartphone on marble surface, soft studio lighting, ultra detailed",
    model="flux.2-pro",
    width=1024,
    height=1024
)
print(f"الصورة المولدة: {image_url}")

🚀 ابدأ بسرعة: نوصي باستخدام منصة APIYI (apiyi.com) للوصول السريع إلى FLUX.2. توفر المنصة واجهات API جاهزة للاستخدام دون الحاجة إلى إعدادات معقدة، وتدعم الاستدعاء المباشر عبر OpenAI SDK.

الطريقة الثانية: API الرسمي من BFL

إذا كنت ترغب في استخدام API الرسمي لشركة Black Forest Labs مباشرة:

import requests
import time

class FLUX2Client:
    """عميل API الرسمي لـ FLUX.2"""

    def __init__(self, api_key):
        self.api_key = api_key
        self.base_url = "https://api.bfl.ai/v1"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    def generate(self, prompt, model="flux-2-pro", **kwargs):
        """
        توليد صورة

        Args:
            prompt: وصف الصورة (الموجه)
            model: flux-2-pro, flux-2-max, flux-2-flex
            **kwargs: width, height, seed, output_format, safety_tolerance
        """
        endpoint = f"{self.base_url}/{model}"

        data = {
            "prompt": prompt,
            "width": kwargs.get("width", 1024),
            "height": kwargs.get("height", 1024),
            "output_format": kwargs.get("output_format", "png")
        }

        # إضافة معلمات اختيارية
        if "seed" in kwargs:
            data["seed"] = kwargs["seed"]
        if "safety_tolerance" in kwargs:
            data["safety_tolerance"] = kwargs["safety_tolerance"]

        response = requests.post(endpoint, json=data, headers=self.headers)
        return response.json()

    def generate_with_flex(self, prompt, steps=50, guidance=4.5, **kwargs):
        """
        التوليد باستخدام FLUX.2 [flex] (يدعم ضبط المعلمات)

        Args:
            prompt: وصف الصورة (الموجه)
            steps: عدد خطوات المعاينة 1-50
            guidance: معامل التوجيه 1.5-10
        """
        data = {
            "prompt": prompt,
            "steps": steps,
            "guidance": guidance,
            "width": kwargs.get("width", 1024),
            "height": kwargs.get("height", 1024)
        }

        response = requests.post(
            f"{self.base_url}/flux-2-flex",
            json=data,
            headers=self.headers
        )
        return response.json()


# مثال على الاستخدام
client = FLUX2Client("YOUR_BFL_API_KEY")

# استخدام إصدار Pro
result = client.generate(
    prompt="A serene Japanese garden with cherry blossoms",
    model="flux-2-pro",
    width=1536,
    height=1024
)
print(f"نتائج توليد Pro: {result}")

# استخدام إصدار Max (أعلى جودة)
result_max = client.generate(
    prompt="A futuristic cityscape at night, neon lights, cyberpunk style, ultra detailed",
    model="flux-2-max",
    width=2048,
    height=2048
)
print(f"نتائج توليد Max: {result_max}")

import asyncio
import aiohttp
from typing import List, Dict

class AsyncFLUX2Client:
    """عميل FLUX.2 غير متزامن، يدعم التوليد المتعدد"""

    def __init__(self, api_key: str, base_url: str = "https://api.apiyi.com/v1"):
        self.api_key = api_key
        self.base_url = base_url
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    async def generate_single(self, session: aiohttp.ClientSession,
                              prompt: str, model: str = "flux.2-pro",
                              width: int = 1024, height: int = 1024) -> Dict:
        """توليد صورة واحدة بشكل غير متزامن"""
        data = {
            "model": model,
            "prompt": prompt,
            "size": f"{width}x{height}",
            "response_format": "url"
        }

        async with session.post(
            f"{self.base_url}/images/generations",
            json=data,
            headers=self.headers
        ) as response:
            return await response.json()

    async def generate_batch(self, prompts: List[str],
                             model: str = "flux.2-pro",
                             max_concurrent: int = 5) -> List[Dict]:
        """
        توليد مجموعة صور دفعة واحدة

        Args:
            prompts: قائمة الموجهات
            model: إصدار النموذج
            max_concurrent: أقصى عدد للطلبات المتزامنة
        """
        semaphore = asyncio.Semaphore(max_concurrent)

        async def limited_generate(session, prompt):
            async with semaphore:
                return await self.generate_single(session, prompt, model)

        async with aiohttp.ClientSession() as session:
            tasks = [limited_generate(session, p) for p in prompts]
            results = await asyncio.gather(*tasks, return_exceptions=True)

        return results


async def main():
    client = AsyncFLUX2Client("YOUR_APIYI_KEY")

    prompts = [
        "A modern minimalist living room with natural lighting",
        "A vintage coffee shop interior with warm tones",
        "A futuristic office space with holographic displays",
        "A cozy bookstore with wooden shelves",
        "A high-tech laboratory with blue lighting"
    ]

    print("بدء التوليد المتعدد...")
    results = await client.generate_batch(prompts, model="flux.2-pro")

    for i, result in enumerate(results):
        if isinstance(result, Exception):
            print(f"فشل توليد الصورة {i+1}: {result}")
        else:
            print(f"الصورة {i+1}: {result['data'][0]['url']}")


if __name__ == "__main__":
    asyncio.run(main())

شرح المعلمات الأساسية لـ FLUX.2 API

المعلمات العامة

توصيات إعدادات الدقة

💡 تحسين التكلفة: للمشاريع ذات الميزانية المحدودة، يمكنك استدعاء FLUX.2 Pro عبر منصة APIYI (apiyi.com) للحصول على أسعار أكثر تنافسية، مما يجعلها مثالية لسيناريوهات التوليد بكميات كبيرة.

المعلمات الحصرية لـ FLUX.2 [flex]

يدعم إصدار FLUX.2 [flex] تحكماً دقيقاً في المعلمات:

تأثير معلمة الخطوات (Steps):

ميزات متقدمة: المراجع المتعددة للصور وتحرير الصور

يدعم FLUX.2 إدخال ما يصل إلى 10 صور مرجعية، مما يتيح ميزات متقدمة مثل نقل الأسلوب (Style Transfer) واتساق الشخصية (Character Consistency):

import base64
import requests

def generate_with_references(prompt, reference_images, model="flux.2-pro"):
    """
    التوليد باستخدام صور مرجعية

    Args:
        prompt: وصف الصورة (الموجه)
        reference_images: قائمة روابط URL أو base64 للصور المرجعية (بحد أقصى 10 صور)
        model: إصدار النموذج
    """
    headers = {
        "Authorization": "Bearer YOUR_APIYI_KEY",
        "Content-Type": "application/json"
    }

    # معالجة الصور المرجعية
    images = []
    for img in reference_images[:10]:  # بحد أقصى 10 صور
        if img.startswith("http"):
            images.append({"type": "url", "url": img})
        else:
            images.append({"type": "base64", "data": img})

    data = {
        "model": model,
        "prompt": prompt,
        "reference_images": images,
        "size": "1024x1024"
    }

    response = requests.post(
        "https://api.apiyi.com/v1/images/generations",
        json=data,
        headers=headers
    )

    return response.json()


# مثال على الاستخدام: الحفاظ على اتساق الشخصية
result = generate_with_references(
    prompt="Same character in a coffee shop, reading a book, warm lighting",
    reference_images=[
        "https://example.com/character_ref1.jpg",
        "https://example.com/character_ref2.jpg"
    ],
    model="flux.2-max"
)

ميزة تحرير الصور

يدعم FLUX.2 تحرير الصور بناءً على اللغة الطبيعية:

def edit_image(source_image, edit_prompt, model="flux.2-pro"):
    """
    تحرير صورة موجودة

    Args:
        source_image: رابط URL أو base64 للصورة المصدر
        edit_prompt: تعليمات التحرير
        model: إصدار النموذج
    """
    headers = {
        "Authorization": "Bearer YOUR_APIYI_KEY",
        "Content-Type": "application/json"
    }

    data = {
        "model": model,
        "prompt": edit_prompt,
        "image": source_image,
        "mode": "edit"
    }

    response = requests.post(
        "https://api.apiyi.com/v1/images/edits",
        json=data,
        headers=headers
    )

    return response.json()


# مثال على الاستخدام
result = edit_image(
    source_image="https://example.com/room.jpg",
    edit_prompt="Change the wall color to light blue, add plants near the window",
    model="flux.2-pro"
)

أفضل الممارسات لكتابة الموجهات في FLUX.2

يتمتع نموذج Mistral-3 24B للغة والرؤية في FLUX.2 بقدرة قوية على فهم الموجهات. إليك بعض النصائح لتحسين موجهاتك:

قالب هيكل الموجه

[وصف العنصر الأساسي] + [تحديد الأسلوب] + [الإضاءة/الأجواء] + [متطلبات التفاصيل] + [محسنات الجودة]

أمثلة لموجهات ممتازة

تقنيات التحكم في الألوان

يدعم FLUX.2 التحكم الدقيق في الألوان باستخدام رموز Hex:

# استخدام أكواد ألوان hex لضمان دقة ألوان العلامة التجارية
prompt = """
A modern tech company logo mockup on business card,
primary color: #FF6B35 (orange),
secondary color: #1A1A2E (dark navy),
clean minimalist design, professional presentation
"""

تحسين التكلفة وأفضل الممارسات

أمثلة على حساب التسعير

استراتيجيات تحسين التكلفة

1. تحسين الدقة: اختر الدقة المناسبة بناءً على الغرض الفعلي من الصورة لتجنب التكاليف الزائدة غير الضرورية.
2. اختيار النموذج: استخدم إصدار Pro لإنتاج المحتوى بكميات كبيرة، واحجز إصدار Max للمحتوى الإبداعي المتميز.
3. تكرار المعاينة: استخدم خطوات (steps) منخفضة في إصدار Flex للمعاينة السريعة، وبمجرد رضاك عن النتيجة، قم بالإنتاج النهائي بجودة عالية.
4. المعالجة بالدفعات: استخدم واجهات الدفعات غير المتزامنة (Asynchronous batch interfaces) لزيادة كفاءة العمل.

💰 مقارنة التكاليف: من خلال الوصول إلى FLUX.2 عبر منصة APIYI (apiyi.com)، يمكنك الحصول على طرق محاسبة أكثر مرونة. بالنسبة للمستخدمين الذين لديهم حجم طلبات شهري كبير، توفر المنصة خصومات تدريجية.

الأسئلة الشائعة

result = generate_image(
    prompt="A red apple on wooden table",
    seed=12345  # تثبيت البذرة
)

import time
from requests.exceptions import Timeout, RequestException

def generate_with_retry(prompt, max_retries=3):
    for attempt in range(max_retries):
        try:
            result = generate_image(prompt, timeout=60)
            return result
        except Timeout:
            if attempt < max_retries - 1:
                time.sleep(2 ** attempt)  # تراجع أسي
            continue
        except RequestException as e:
            print(f"خطأ في الطلب: {e}")
            break
    return None

ملخص دمج واجهة برمجة تطبيقات FLUX.2

تمثل سلسلة FLUX.2 قمة تكنولوجيا توليد الصور الحالية. إليك النقاط الأساسية التي يتناولها هذا المقال:

مسار الوصول الموصى به:

1. زيارة apiyi.com لإنشاء حساب
2. الحصول على مفتاح API
3. استخدام أمثلة الأكواد البرمجية في هذا المقال للدمج السريع
4. ضبط الموجهات والمعلمات بناءً على النتائج

من خلال منصة APIYI، يمكنك الوصول بسرعة إلى FLUX.2 Pro وMax، والاستمتاع بمزايا الواجهة الموحدة، والخدمة المستقرة، والفوترة المرنة.

قراءات إضافية:

• الوثائق الرسمية لـ FLUX.2: docs.bfl.ai
• تعريف بنماذج FLUX.2: bfl.ai/models/flux-2
• المدونة الرسمية لـ FLUX.2: bfl.ai/blog/flux-2

كتب هذا المقال الفريق التقني لـ APIYI. لمزيد من المعلومات حول حلول الوصول إلى واجهات برمجة تطبيقات نماذج الذكاء الاصطناعي، تفضل بزيارة apiyi.com