البدء السريع: توصيل العميل الخاص بك
ابدأ في إرسال الطلبات فوراً باستخدام عنوان URL الأساسي الخاص بنا. استبدل YOUR_API_KEY باستخدام المفتاح من لوحة التحكم الخاصة بك. تستخدم واجهة برمجة التطبيقات الخاصة بنا رؤوس قياسية للمصادقة.
- URL الأساسي:
https://api.nsfwollama.com/v1 - معرف النموذج:
uncensored
curl https://api.nsfwollama.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize this log file"}]
}'
نقطة النهاية: /v1/chat/completions
أرسل الرسائل لتوليد النص. أرسل طلب POST إلى /v1/chat/completions مع معرف النموذج الخاص بك ومصفوفة الرسائل. تدعم نافذة السياق 100,000 رمز إجمالاً. يشمل ذلك رموز الطلب والإكمال معاً.
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwollama.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)
نقطة النهاية: /v1/models
اكتشف النماذج المتاحة. GET /v1/models لعرض نقاط النهاية. تقدم واجهة برمجة التطبيقات الخاصة بنا نموذج لغة كبير واحداً محسناً للاستجابات غير الخاضعة للرقابة. لا تدعم التضميمات أو توليد الصور. تحقق من قائمة النماذج للتأكد من التوفر.
المعلمات: درجة الحرارة وTop P والمزيد
تحكّم في نمط التوليد باستخدام المعاملات القياسية. اضبط temperature للإبداع. اضبط top_p للعينة النواة. استخدم response_format مع json_object لمخرجات مُهيّأة. يمكنك أيضًا ضبط seed لضمان إمكانية إعادة الإنتاج. تعمل هذه المعاملات تمامًا مثل SDK الخاص بـ OpenAI.
استجابات البث واستهلاك الرموز
احصل على مخرجات في الوقت الفعلي عبر أحداث الإرسال من الخادم. يقلل البث من زمن الاستجابة المُدرَك للاستجابات الطويلة. تظهر تفاصيل استخدام الرموز في الشريحة الأخيرة. يتيح لك ذلك تتبع التكاليف بدقة. تفرض واجهة برمجة التطبيقات (API) لدينا رسومًا فقط على الرموز الفعلية المعالجة. الأخطاء مجانية.
stream = 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)
معالجة الأخطاء & الحدود
تعامل مع أخطاء HTTP القياسية بسلاسة. يعني 401 أن مفتاح API الخاص بك غير صالح. يشير 402 إلى عدم كفاية الرصيد المدفوع مسبقًا. يشير 429 إلى أنك تجاوزت حد 300 طلب في الدقيقة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. تحصل على 8 طلبات متزامنة لكل مفتاح. لا يتم إصدار استرداد الأموال مقابل الرصيد، ولكن يمكن للدعم إصلاح أخطاء الفوترة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwollama.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);