AR ▾
احصل على مفتاح API

واجهة برمجة تطبيقات LLM لموجّهات Flux: سير عمل عملي

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

محدّث

طرفية تغذي شرائط من النص على ناقل إلى إطار صورة فارغ، تُظهر الموجّهات المكتوبة قبل الصور

نقاط رئيسية

  • استخدم رسالة نظام لتثبيت التنسيق والأسلوب مرة واحدة، ثم أرسل الفكرة القصيرة فقط لكل طلب.
  • يعيد وضع JSON قائمة بتنوعات الموجّه التي يمكن للسكربت التكرار عليها دون تحليل نص حر.
  • تسمح نافذة الـ 100,000 رمز بلصق دليل الأسلوب أو الموجّهات السابقة في الطلب.
  • تكلفة التوسيع الكامل جزء من سنت واحد، ولا يرى النموذج الصورة ولا يصنعها.

النسخة المختصرة

أنشئ مفتاح API، وجّه عميل OpenAI إلى https://api.fluxapikey.com/v1، وحدد النموذج على uncensored، وضع قواعد الموجّه في رسالة النظام. كل رسالة مستخدم هي مجرد فكرة: بضع كلمات، مشهد، أو شخصية. الرد هو الموجّه الجاهز. انسخه إلى أي أداة صور تستخدمها، والتي لها مفتاحها الخاص ورسومها الخاصة.

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

لماذا استخدام نموذج لغوي للموجّهات

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

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

موجّه نظام يعمل

معظم الجودة تأتي من رسالة النظام. اجعلها قصيرة، محددة وقابلة للاختبار. إليك نقطة بداية يمكنك تعديلها:

SYSTEM = '''You write prompts for a text-to-image model.
Output exactly one prompt, one paragraph, no preamble, no quotes.
Order: subject, action, setting, lighting, camera or medium, palette, mood.
Use concrete nouns and visual adjectives. Avoid abstract words like beautiful.
Do not mention the words prompt, image or render.
Keep it under 90 words.'''

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

أظهر، لا تصف

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

إرسال الطلب

الاستدعاء هو إكمال دردشة قياسي. الإعدادات الأكثر أهمية للتوسيع الإبداعي هي درجة الحرارة والبذرة.

from openai import OpenAI

client = OpenAI(base_url="https://api.fluxapikey.com/v1", api_key="YOUR_KEY")

def expand(idea, seed=None):
    r = client.chat.completions.create(
        model="uncensored",
        messages=[
            {"role": "system", "content": SYSTEM},
            {"role": "user", "content": idea},
        ],
        temperature=0.9,
        top_p=0.95,
        max_tokens=200,
        seed=seed,
    )
    return r.choices[0].message.content.strip()

print(expand("an abandoned observatory on a cliff", seed=7))

درجة حرارة حول 0.8 إلى 1.0 تعطي صياغة متنوعة، وهو ما تريده عند العصف الذهني. اخفضها نحو 0.3 عندما تحتاج إلى مخرجات متطابقة تقريباً لقالب متكرر. يتم تمرير seed، top_p، stop ومعاملات العقوبة إلى النموذج، لذا يمكنك استخدامها كما تفعل في أماكن أخرى. حد max_tokens اختياري؛ ضبطه بالقرب من الطول المتوقع يمنع الإجابة من الإطالة بلا ضابط. انظر إلى المستندات لكل معلمة مدعومة.

دفعات من التنوعات مع وضع JSON

للدفعة، اطلب قائمة وقم بتمكين وضع JSON مع response_format. يجب أن تخبر رسالة النظام النموذج بشكل الإخراج المطلوب، لأن وضع JSON يجعل المخرجات JSON صالحاً لكنه لا يختار مفاتيحك لك.

# client as above: base_url https://api.fluxapikey.com/v1
import json

def variations(idea, n=8):
    r = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        messages=[
            {"role": "system", "content": SYSTEM + f"\nReturn JSON: {{\"prompts\": [{n} strings]}}."},
            {"role": "user", "content": idea},
        ],
        temperature=1.0,
    )
    return json.loads(r.choices[0].message.content)["prompts"]

for p in variations("a night market in the rain"):
    print(p)

لفّ json.loads داخل كتلة try على أي حال. إذا تم قطع الرد بواسطة max_tokens منخفضة جداً، فلن يتم تحليله، لذا اترك هذا المعامل سخياً لطلبات القائمة. يمكن إرسال كل موجّه في القائمة مباشرة إلى خدمة الصور الخاصة بك في حلقة.

استخدام نافذة السياق ذات 100,000 رمز

نافذة السياق هي 100,000 رمز، تحسب الموجّه بالإضافة إلى الإكمال. لعمل الموجّهات، هذا أكثر مما تحتاجه لكل طلب، لكنه مفيد بطريقتين. يمكنك لصق دليل أسلوب طويل، ورقة شخصية أو قائمة من الموجّهات السابقة التي نجحت، وسيتبعها النموذج. ويمكنك الحفاظ على محادثة عمل مستمرة: اطلب موجهاً، قل "أكثر قتامة، أضف ضباباً"، واحصل على واحد معدل يتذكر الأول.

الإدخال الطويل يكلف المال، لذا اقصر دليل الأسلوب الثابت على ما يغيّر المخرجات. خمسمئة رمز من القواعد رخيصة. خمسون ألف رمز من الموجّهات القديمة المرسلة مع كل طلب تتراكم، كما يظهر قسم التكلفة أدناه: 50,000 رمز إدخال إضافي هو $0.0075 لكل طلب، أو $3.75 عبر 500 طلب.

أنماط الموجّهات للمهام الشائعة

نفس نقطة النهاية تغطي مهام مختلفة متعددة. ما يتغير هو رسالة النظام.

  • أوراق الشخصيات. احتفظ بوصف ثابت لشخصية متكررة (الشعر، الملابس، العمر، البنية) في رسالة النظام، وأرشد النموذج لتكرارها حرفياً في كل موجّه. هذه أرخص طريقة للحفاظ على شخصية قابلة للتعرف عليها عبر سلسلة من الصور المُنتَجة.
  • نقل الأسلوب بالكلمات. قدّم قائمة بمصطلحات الأسلوب التي تفضلها، مثل "غواش، لوحة ألوان خافتة، حُبيبات"، واطلب تضمينها في الجملة الأخيرة من كل موجّه.
  • الصياغة السلبية. إذا كانت أداة الصور الخاصة بك تأخذ موجهاً سلبياً منفصلاً، اطلب من النموذج إرجاع حقلين في وضع JSON: prompt و negative. اجعل القائمة السلبية قصيرة ومحددة.
  • الاختصار. بعض الأدوات تقطع المدخلات الطويلة. أضف حدًا لعدد الكلمات إلى القواعد واختبره، لأن النماذج تحسب الكلمات بشكل تقريبي.

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

الاختبار وضبط الحلقة

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

ابحث عن ثلاثة أعراض. الموجّهات التي تتكرر بنفس الكلمات الافتتاحية عبر دفعة تعني أن درجة الحرارة منخفضة جدًا أو أن الأمثلة موحدة للغاية. الموجّهات التي تتجاهل حد الكلمات الخاص بك تعني أن القاعدة مدفونة؛ انقلها إلى نهاية الرسالة. الموجّهات التي تتضمن مقدمات محادثة مثل "إليك الموجّه الخاص بك" تعني أن قاعدة التنسيق تحتاج إلى أن تكون أكثر صرامة، أو يمكنك إزالة السطر الأول في الكود. البث المتدفق مع stream: true متاح إذا كنت تعرض النتائج في واجهة مستخدم، ويتم الإبلاغ عن الاستخدام في نهاية البث.

الحدود للتخطيط حولها

ثلاثة حدود صادقة. أولاً، النموذج للنصوص فقط: لا يستطيع رؤية صورة، لذا لا يمكنه الحكم على ما إذا كان الموجّه قد أنتج صورة جيدة. أنت الحكم، والحلقة هي: اكتب، أنشئ الصورة، عدّل القواعد. ثانياً، لا يعرف النموذج أي تفاصيل خاصة بنموذج الصور الخاص بك ما لم تخبره، لذا أضف تلك التفاصيل إلى رسالة النظام. ثالثاً، حدود المعدل: المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 في الدقيقة، بينما المفتاح التجريبي يسمح بـ 2 و60. إذا تجاوزت الحلقة هذه الحدود، ستحصل على خطأ HTTP 429 مع الكود concurrency أو rate_limited؛ انتظر لحظة وأعد المحاولة. إذا كان الخطأ 429 مصحوباً بالرأس Retry-After: 5، فهذا يعني ازدحاماً مؤقتاً، وينطبق عليه نفس النصيحة.

التكلفة لكل موجّه

التسعير هو $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج. لنفترض أن كل طلب يرسل رسالة نظام مكونة من 800 رمز بالإضافة إلى الفكرة ويعيد موجّهًا مكونًا من 200 رمز. عبر 500 طلب، يكون ذلك 400,000 رمز مدخل و100,000 رمز مخرج. المدخلات: 0.4 × $0.15 = $0.06. المخرجات: 0.1 × $0.50 = $0.05. الإجمالي: $0.11 مقابل 500 موجّه.

دفعة JSON المذكورة أعلاه، بحوالي 400 رمز مدخل و700 رمز مخرج لكل استدعاء، تكلف 0.0004 × $0.15 زائد 0.0007 × $0.50، أي $0.00006 + $0.00035 = $0.00041 لثمانية موجّهات. رصيد التجربة هو $0.50، يمكن المطالبة به بنقرة واحدة بعد التسجيل. تبدأ الشحنات بمبلغ $20؛ انظر صفحة التسعير لمعرفة مستويات المكافآت، وصفحة المفاتيح للبدء.

أسئلة وأجوبة

هل يمكن للنموذج كتابة موجّهات لأي مولد صور؟

نعم، لأنه ينتج النص فقط. أخبره بالصيغة المفضلة لأداة الصور لديك في رسالة النظام، ثم انسخ النتيجة.

هل سيرفض الموضوعات الناضجة أو الداكنة؟

تم ضبطه للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. لا يُسمح أبدًا بمحتوى جنسي يتضمن القاصرين.

كم عدد الموجّهات التي يمكنني إنشاؤها في الدقيقة؟

يسمح المفتاح الكامل بـ 300 طلب في الدقيقة و8 في آن واحد. مع وضع JSON، يمكن لطلب واحد إرجاع عدة موجّهات.

هل يولد الصور أيضًا؟

لا. واجهة برمجة التطبيقات للنص فقط، بدون توليد صور أو صوت أو فيديو.

مفتاحك على بُعد استمارة واحدة

أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان base URL. هذا هو الإعداد كله.

احصل على مفتاح API