توثيق واجهة برمجة التطبيقات

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

تستخدم واجهة برمجة التطبيقات مصادقة رمز حامل القياسية. تتلقى مفتاحك فوراً بعد التسجيل باستخدام Google أو عنوان بريد إلكتروني. اضبط Authorization الرأس إلى Bearer YOUR_API_KEY لجميع الطلبات. عنوان URL الأساسي هو https://api.llmstatus.cc/v1. يعمل هذا الـ Endpoint مع أي SDK متوافق مع OpenAI أو عميل متوافق. تحتاج فقط إلى تغيير عنوان URL الأساسي وتقديم مفتاحك. لا يتطلب التسجيل رقم هاتف. يظل هويتك بسيطة بينما تحصل على وصول كامل.

الطلب الأول

أرسل طلب POST إلى /v1/chat/completions للحصول على استجابة فورية. معرف النموذج هو uncensored. يتعامل مع المحتوى البالغ، وأبحاث الأمن، والمواضيع المثيرة للجدل بدون رفض. لا تحتاج إلى اشتراك أو رسوم شهرية. لا تستهلك الأخطاء رصيدك المدفوع مسبقاً. أرسل مطالبتك واحصل على إخراج نصي مباشرة.

Copycurl https://api.llmstatus.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the server timezone to UTC."}]
  }'

يوضح هذا الطلب أبسط تفاعل ممكن. يعيد الخادم كائن JSON يحتوي على النص المُولّد. يمكنك ضبط معلمات مثل درجة الحرارة (temperature) أو top_p للتحكم في الإبداع. يتضمن الرد إحصائيات الاستخدام للشفافية. ابدأ بهذا الاتصال الأساسي للتحقق من صحة مفتاح API الخاص بك.

تكامل واجهة برمجة تطبيقات Python

استخدم الرسمي openai مكتبة Python للتفاعل مع واجهة برمجة التطبيقات. قم بتهيئة العميل بعنوان URL الأساسي ومفتاح واجهة برمجة التطبيقات. يتعامل العميل مع التسلسل وتحليل الأخطاء نيابةً عنك. تقلل هذه الطريقة بشكل كبير من كود الهيكل العظمي. يمكنك تمرير الرسائل كقائمة من الكائنات القاموسية. يبقى النموذج uncensored بغض النظر عن غلاف العميل. يتم دعم كل من وضعي البث المباشر وغير المباشر. هذه الطريقة مثالية لخدمات الخلفية أو سكريبتات معالجة البيانات.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.llmstatus.cc/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)

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

استخدام SDK Node.js

تثبيت openai npm package for Node.js environments. Set the environment variable or pass the key directly to the constructor. The base URL must point to our service. This allows you to build serverless functions or web apps quickly. The SDK supports both CommonJS and ES modules. You can stream responses or get them in one go. The API key is passed securely in the header. This setup is perfect for JavaScript developers who need reliable text generation. No extra configuration is needed beyond the key and base URL.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.llmstatus.cc/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);

يعكس SDK لـ Node بنية عميل Python. ترسل الرسائل وتتلقى الإكمالات. معالجة الأخطاء مدمجة في سلسلة الوعود. هذا يضمن بقاء تطبيقك قوياً. استخدم هذه الطريقة لواجهات الدردشة في الوقت الفعلي أو الوظائف الخلفية. الكود موجز وسهل الصيانة. يمكنك تمديده برؤوس مخصصة إذا لزم الأمر.

استجابات البث

فعّل البث عن طريق تعيين stream: true في طلبك. يرسل الخادم أحداث خادم المراسلة (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)

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

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

لديك نافذة سياق بحجم 100,000 رمز للإدخال والمخرجات مجتمعة. الحد الأقصى للمخرجات هو 16,000 رمز لكل طلب. الحد هو 300 طلب في الدقيقة لكل مفتاح. يمكنك إجراء 8 طلبات متزامنة في آن واحد. لا يمكن أن يتجاوز جسم الطلب 8 ميجابايت. يعني خطأ 401 أن مفتاحك غير صالح. يشير خطأ 402 إلى عدم وجود رصيد متبقي. يشير خطأ 429 إلى تجاوز حد معدل الطلب. لا تنتهي صلاحية الرصيد أبداً، لذا يمكنك الشحن لاحقاً. الأخطاء لا تخصم رصيدك. استخدم هذه الأرقام لتصحيح أخطاء التكامل بسرعة. الـ API صارم ولكن قابل للتنبؤ. خطط للتزامن بناءً على حد الطلبات الثمانية.