مفتاح Flux API: ماهيته ومكان ملاءمة API النص
مفتاح Flux API هو بيانات اعتماد لخدمة توليد الصور، وهذا الموقع لا يبيع واحدة. ما يبيعه هو مفتاح مختلف، لـ API LLM نصي مُستضاف يمكنه كتابة وتوسيع الموجّهات التي تغذيها لنموذج الصور.
محدّث

نقاط رئيسية
- مفتاح خدمة صور Flux ومفتاح واجهة برمجة تطبيقات النصوص LLM شيئان منفصلان، يصدرهما مزودان منفصلان.
- هذا الموقع مخصص للنصوص فقط: لا يوجد توليد صور أو صوت أو فيديو، ولا يديره أي بائع لنماذج الصور.
- يكون المفتاح النصي مفيدًا بجانب مفتاح الصور لأن كتابة الموجّه مهمة نصية تُحسب حسب الرمز.
- تغيّر عنوان URL أساسيًا واحدًا ومفتاحًا واحدًا في أي عميل OpenAI للبدء، ويغطي الرصيد التجريبي الاختبارات الأولى.
ما يعنيه الناس عادةً بمفتاح Flux
Flux هو اسم عائلة من نماذج النص إلى الصور. عندما يكتب شخص ما flux api key في مربع البحث، فهو يريد عادةً بيانات اعتماد تسمح لبرمجته بإرسال موجّه إلى خدمة تستضيف أحد نماذج الصور هذه للحصول على صورة. تأتي بيانات الاعتماد من أي شركة تشغل نقطة النهاية للصور التي اخترتها. وهي مرتبطة بحسابهم، وفواتيرهم وشروطهم.
ستلاحظ استخدام العبارة بعدة طرق مختلفة قليلاً، ومن المفيد فرزها قبل لصق مفتاح في أي مكان:
- مفتاح من مزود صور يستضيف نماذج Flux، يُستخدم في طلب يُرجع صورة.
- مفتاح للإعداد المحلي أو المستضاف ذاتيًا، حيث تنشئ الرمز بنفسك ولا يغادر جهازك شيء.
- مفتاح لأداة أخرى في خط أنابيبك، مثل نموذج نصي يكتب الموجّهات، والذي يُطلق عليه اسم Flux فقط لأن المشروع يحمل هذا الاسم.
فقط الأولان ينتجان صورًا. الثالث هو مكان وجود هذا الموقع. نحن ندير واجهة برمجة تطبيقات LLM متوافقة مع OpenAI، ويعمل المفتاح الذي تحصل عليه هنا مع واجهة برمجة التطبيقات هذه وليس أي شيء آخر.
لماذا لن يستدعي مفتاح الصور نموذج محادثة
يبدو نوعا المفتاح متشابهين، لأنهما سلاسل طويلة ترسلها في رأس Authorization، لكنهما يفتحان أبوابًا مختلفة. يتم التحقق من مفتاح مزود الصور من قبل مزود الصور. إذا أرسلته إلى نقطة نهاية دردشة، فستحصل على خطأ في المصادقة، والعكس صحيح تمامًا: إذا أرسلت مفتاحًا من هذا الموقع إلى مضيف صور، فسيُرجع خطأ.
تختلف أيضًا هياكل الطلبات. يحمل استدعاء الصور عادةً موجّهًا، وأبعادًا، وبذرة، وعدد الصور. يحمل استدعاء الدردشة قائمة من الرسائل مع الأدوار، ويعيد النص. لا يوجد مخطط مشترك، لذلك لا يوجد شيء لترجمته بينهما. إذا كان لديك برنامج نصي يعمل مع مضيف الصور، فاحتفظ بذلك البرنامج النصي ومفتاحه كما هما بالضبط. أضف استدعاء النص كخطوة منفصلة أمامه.
ما لا تفعله هذه الخدمة
لإبقاء التوقعات واضحة: واجهة برمجة التطبيقات هنا مخصصة للنصوص فقط. لا تولد الصور أو الصوت أو الفيديو، ولا تنشئ المتجهات، ولا تقدم ضبطًا دقيقًا. إنها ليست واجهة برمجة التطبيقات الرسمية لأي بائع نماذج وليست موجّهًا (راوتر) بين البائعين. تخدم نموذجًا واحدًا مفتوح الأوزان، مضبوطًا للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، وتشغله شركة مستقلة. معرف النموذج الذي تمرره هو uncensored.
أين يناسب واجهة برمجة تطبيقات النص بجانب مفتاح الصور
كتابة الموجّهات هي نقطة الالتقاء الواضحة. تستجيب نماذج الصور جيداً للوصف المحدد والمنظم: الموضوع، والمشهد، والعدسة، والإضاءة، واللون، والمزاج. يكتب معظم الناس هذه الوصف يدوياً، ثم يعيدون صياغتها بعد نتيجة سيئة. يمكن لنموذج نصي أن يكتب المسودة الأولى، أو يوسع فكرة مكونة من ثلاث كلمات إلى وصف كامل، أو ينتج عشرين تنويعاً حول موضوع بينما تذهب للحصول على القهوة.
بعض المهام التي تناسب هذه الخدمة جيداً:
- التوسيع. حوّل فكرة قصيرة إلى موجّه مفصل بأسلوب تحدده مرة واحدة في رسالة النظام.
- التنوع. اطلب عشر إصدارات مختلفة من موضوع واحد، مُرجعة كقائمة JSON يمكن لبرنامجك التكرار عليها.
- التنظيف. أعد كتابة موجّه فوضوي كتبه عميل ليصبح شيئًا يتعامل معه نموذج الصور بشكل أفضل.
- السكربتات والتعليقات التوضيحية. اكتب السرد أو قائمة اللقطات أو التعليق التوضيحي الذي تذهب بجانب الصورة.
نظراً لأن النموذج هنا لا يرفض بشكل افتراضي، فهو يناسب الخيال، وتصميم الشخصيات والمواضيع الناضجة التي غالباً ما ترفضها النماذج المستضافة الأخرى، طالما كان الاستخدام قانونياً ويتضمن بالغين. ينطبق قيد صارم واحد في كل مكان: لا محتوى جنسي يتضمن قاصرين. مثل هذه الطلبات ليست شيئاً ندعمه بأي شكل من الأشكال.
أول طلب في أقل من دقيقة
يعمل أي عميل SDK أو HTTP لـ OpenAI بمجرد استبدال عنوان URL الأساسي والمفتاح. نقطة النهاية للدردشة هي POST /v1/chat/completions، وGET /v1/models يسرد النموذج. إليك نفس الطلب في curl وفي Python.
curl https://api.fluxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
{"role": "user", "content": "a lighthouse in a storm, painterly"}
]
}'
from openai import OpenAI
client = OpenAI(
base_url="https://api.fluxapikey.com/v1",
api_key="YOUR_KEY",
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
{"role": "user", "content": "a lighthouse in a storm, painterly"},
],
)
print(reply.choices[0].message.content)
أي سلسلة يتم إرجاعها هي ما تعطيه لخدمة الصور الخاصة بك، باستخدام مفتاح الخدمة الخاص بها. لا يتلامس الاثنان مع بعضهما البعض. للحصول على القائمة الكاملة للمعلمات، بما في ذلك البث المتدفق، واستدعاء الدوال، ووضع JSON، انظر إلى توثيق واجهة برمجة التطبيقات.
هل تحتاج إلى كلا المفتاحين؟
يعتمد ذلك على ما تبنيه. الجدول أدناه طريقة سريعة لاتخاذ القرار.
| هدفك | مفتاح الصور | مفتاح النصوص |
|---|---|---|
| توليد صور من الموجّهات التي تكتبها بنفسك | نعم | لا |
| توليد صور من موجّهات يكتبها النموذج أو يوسعها | نعم | نعم |
| كتابة قصص، حوار أو سيناريوهات فقط | لا | نعم |
| بناء تطبيق دردشة أو لعب أدوار للبالغين | لا | نعم |
| إنتاج دفعة من مئات تنويعات الموجّهات | اختياري | نعم |
إذا كنت تكتب فقط موجّهاتك الخاصة وراضٍ عنها، فإن مفتاح النص يضيف القليل. إذا وجدت نفسك تعيد كتابة الموجّهات طوال فترة بعد الظهر، أو تحتاج إلى حجم، فإنه يكسب تكلفته بسرعة. لدينا أيضًا دليل موجز حول استخدام LLM نصي في سير عمل الفيديو، الذي يتبع نفس فكرة خطوة النص أمام خطوة الوسائط.
أخطاء ناتجة عن الخلط بين المفاتيح
معظم المشاكل في إعداد الخدمة المزدوجة صغيرة وسهلة التمييز بمجرد معرفة ما تبحث عنه.
- عنوان URL الأساسي الخاطئ. إذا كان عميلك لا يزال يشير إلى المضيف القديم، فسيتم رفض المفتاح الجديد. تحقق من أن عنوان URL الأساسي ينتهي بـ
/v1ويتطابق مع المثال أعلاه. - اسم النموذج الخاطئ. معرف النموذج الوحيد هنا هو
uncensored. تمرير اسم نموذج الصور يُرجع خطأ، لأنه لا يوجد مثل هذا النموذج في واجهة برمجة التطبيقات هذه. - المفاتيح في متغير بيئة واحد. امنح كل خدمة متغيرها الخاص، على سبيل المثال
TEXT_API_KEYوIMAGE_API_KEY. مشاركة اسم واحد هي كيف ينتهي المفتاح مرسلًا إلى المضيف الخاطئ. - توقع الصور في الرد. الرد هو نص عادي في
choices[0].message.content. إذا كنت بحاجة إلى صورة، يجب أن يذهب هذا النص إلى خدمة الصور الخاصة بك كاستدعاء ثانٍ. - تجاهل 429. يؤدي الاندفاع فوق 8 طلبات متزامنة إلى إرجاع 429 مع رمز الخطأ
concurrency، وفوق 300 طلب في الدقيقة معrate_limited. تراجع لفترة قصيرة وأعد المحاولة. يحتفظ الطلب المتدفق بمكانه حتى ينتهي البث، لذا أغلق البث الذي لم تعد تقرأه.
مفتاح التجربة له سقف أقل: 2 طلب متزامن و60 في الدقيقة. هذا كافٍ لاختبار خطوة كتابة الموجّه يدوياً، لكن الدفعة الكبيرة يجب أن تنتظر مفتاحاً تم شحن الرصيد فيه.
كم تكلف كتابة الموجّه
الفوترة تكون حسب الرمز ومسبقة الدفع: $0.15 لكل 1M رمز إدخال و$0.50 لكل 1M رمز إخراج، بدون اشتراك. مهام الموجّه صغيرة، لذا تكون الأرقام صغيرة. خذ طلباً يحتوي على رسالة نظام بحجم 600 رمز بالإضافة إلى الفكرة (إدخال) وموجّه موسّع بحجم 250 رمز (إخراج). تكلفة الإدخال هي 600 / 1,000,000 × $0.15 = $0.00009. تكلفة الإخراج هي 250 / 1,000,000 × $0.50 = $0.000125. طلب واحد يكلف $0.000215.
مجموعة من 1,000 طلب من هذا النوع تكلف حوالي $0.215. رصيد التجربة بقيمة $0.50، الذي يمكنك الحصول عليه بنقرة واحدة في صفحة مفتاح API بعد تسجيل الدخول، يغطي حوالي 2,300 منها (0.50 / 0.000215). لا يحتاج إلى بطاقة وصلاحيته 7 أيام. الطلبات الفاشلة أو المرفوضة لا تُحسب تكلفتها، والرصيد الذي تضيفه لاحقاً لا ينتهي. التفاصيل موجودة في صفحة التسعير.
الحصول على مفتاح النصوص الخاص بك
سجّل باستخدام Google، أو باستخدام بريد إلكتروني وكلمة مرور، ثم افتح صفحة مفتاح API. احصل على رصيد التجربة هناك إذا أردت الاختبار أولاً. تبدأ الشحنات المدفوعة من $20 إلى $500 بأي مبلغ صحيح، مع مكافأة +5% من $50، و+10% من $100، و+15% من $200. يمكنك الدفع بالعملات المشفرة فقط (USDT على TRC20، USDC على Base).
أبقِ المفتاح بعيداً عن الكود في جانب العميل وعن المستودعات العامة. الموجّهات التي ترسلها لا تُستخدم للتدريب، لكن تسرّب المفتاح يستهلك رصيدك. المفتاح الكامل يسمح بـ8 طلبات متزامنة و300 طلب في الدقيقة، لذا يمكن تشغيل دفعة الموجّه بالتوازي دون عمل إضافي.
المزيد من الأدلة
أسئلة وأجوبة
هل يمكنني استخدام هذا المفتاح لتوليد صور باستخدام Flux؟
لا. يعمل المفتاح فقط مع API النص الخاص بهذا الموقع. يتطلب توليد الصور مفتاحًا من مزوّد يستضيف نموذج الصور.
هل هذا هو API الرسمي لـ Flux؟
لا. هذا API نصي مستقل ومستضاف ومتوافق مع OpenAI، يحتوي على نموذج واحد فقط اسمه uncensored. لا يديره أي بائع لنماذج الصور ولا يعيد بيع خدماتهم.
هل يمكن للنموذج النصي كتابة موجّهات لأداة الصور الخاصة بي؟
نعم. اطلب موجّهًا في رسالة النظام، خذ نص الرد وألصقه أو أرسله إلى خدمة الصور الخاصة بك. تظل الخدمتان مستقلتين.
هل أحتاج إلى بطاقة لتجربته؟
لا. يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد التجربة بنقرة واحدة في صفحة المفتاح، صالح لمدة 7 أيام، دون الحاجة إلى بطاقة.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.