Flux API: الموجّهات والنصوص عبر نقطة النهاية

عنوان URL الأساسي والمصادقة

يتبع API الخاص بنا هيكل chat-completions القياسي من OpenAI. للبدء، تحتاج إلى عنوان URL أساسي ومفتاح API. عنوان URL الأساسي لجميع الطلبات هو https://api.fluxapikey.com/v1. يمكنك الحصول على مفتاح API عن طريق التسجيل في صفحة الحصول على مفتاح API باستخدام البريد الإلكتروني وكلمة المرور فقط. لا يتطلب الأمر بطاقة ائتمان للتجربة.

مرّر مفتاحك في رأس Authorization كرمز Bearer. يُقتصر كل حساب على مفتاح واحد في كل مرة؛ وإعادة توليد المفتاح تلغي سريان المفتاح السابق. لا تُستخدم الموجّهات في التدريب، والحدّ الصارم الوحيد للمحتوى هو عدم وجود محتوى جنسي يتضمن قاصرين.

إرسال طلبك الأول

قم بإرسال طلب POST إلى /v1/chat/completions مع الموجّه الخاص بك. معرف النموذج هو دائماً uncensored. تقبل نقطة النهاية حمولات JSON القياسية وتعيد استجابات نصية. تدعم البث عبر أحداث الإرسال من الخادم (SSE) واستدعاء الأداة/الدالة.

إليك مثال أساسي باستخدام curl:

Copycurl https://api.fluxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

يُرسِل هذا الطلب نصك إلى خوادم GPU الخاصة بنا. النموذج مُعدّ للإجابة دون رفض للمواضيع القانونية للبالغين، أو الخيالية، أو المثيرة للجدل. يمكنك ضبط معاملات max_tokens و temperature حسب الحاجة.

تكامل حزمة SDK الخاصة بـ Python

استخدم حزمة SDK الرسمية الخاصة بـ OpenAI للغة Python للتفاعل مع API الخاص بنا. اضبط عنوان URL الأساسي على نقطة النهاية الخاصة بنا وقم بتوفير مفتاح API الخاص بك. هذا يتيح لك استخدام الأساليب المألوفة مثل client.chat.completions.create.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

يضمن هذا الإعداد التوافق مع قواعد الشيفرة الموجودة. يحتوي كائن الاستجابة على النص المُولّد في response.choices[0].message.content. يمكنك تحليل هذا النص للحصول على نصوص برمجية، أو تسميات، أو استخراج بيانات وصفية في سير عمل الفيديو أو الصوت الخاص بك.

استخدام حزمة SDK الخاصة بـ Node.js

لبيئات JavaScript، استخدم حزمة SDK الخاصة بـ OpenAI لـ Node.js. قم بتكوين خصائص baseURL و apiKey لتشير إلى خدمتنا. هذا يتيح التكامل السلس في تطبيقات Node.js لتوليد النص في الوقت الفعلي.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.fluxapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

هيكل الاستجابة يطابق تنسيق OpenAI. يمكنك الوصول إلى المحتوى المُولّد والتعامل مع الأخطاء باستخدام كتل try-catch القياسية. هذا النهج مثالي للمعالجة من جانب الخادم في تطبيقات الويب أو أدوات CLI.

استجابات البث المتدفق عبر SSE

فعّل البث عن طريق تعيين stream: true في طلبك. يعيد API أحداث الإرسال من الخادم (SSE) مع أجزاء نصية متزايدة. هذا مفيد للتطبيقات في الوقت الفعلي حيث تريد عرض النص أثناء توليده.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

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

الحدود، الأخطاء، ونافذة السياق

لدينا حدود محددة لضمان الموثوقية. يمكنك إرسال ما يصل إلى 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. تدعم نافذة السياق 100,000 رمز (token) للموجّه والإكمال معاً.

تشمل الأخطاء الشائعة 401 للمفاتيح غير الصالحة، و402 لعدم كفاية الرصيد، و429 لحدّ المعدل. إذا تجاوزت حدّ المعدل، انتظر وأعد المحاولة. أسعارنا شفافة: $0.25 لكل مليون رمز (token) مدخل و $1.00 لكل مليون رمز (token) مخرج. الرصيد المسبق الدفع لا ينتهي، ويمكنك شحن الرصيد من $10.