توثيق واجهة برمجة التطبيقات للنموذج غير الخاضع للرقابة

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

ابدأ بإرسال الطلبات إلى https://api.bestllmapiprovider.com/v1 مع مفتاح API الخاص بك. يحل عنوان URL الأساسي محل نقطة النهاية القياسية لـ OpenAI في تكوين العميل الخاص بك. مرر المفتاح في Authorization: Bearer <key> الرأس لكل مكالمة. يعمل هذا مع مكتلات SDK الرسمية الخاصة بـ OpenAI وأي عميل متوافق مع OpenAI.

العناوين المطلوبة

• Content-Type: application/json
• Authorization: Bearer YOUR_API_KEY

حافظ على أمان مفتاحك. إذا فقدته، أنشئ مفتاحًا جديدًا من لوحة التحكم. يتوقف المفتاح القديم عن العمل على الفور.

Copycurl https://api.bestllmapiprovider.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate the total cost for 50k tokens"}]
  }'

البدء السريع: أرسل طلبك الأول غير الخاضع للرقابة

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

مثال للحمولة

• model: "uncensored"
• messages: [{"role": "user", "content": "Explain quantum entanglement."}]

تتعامل هذه نقطة النهاية مع توليد النصوص فقط. لا تدعم الصور أو الصوت. استخدم المعلمات أدناه للتحكم في نمط المخرجات.

Copyfrom openai import OpenAI

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

المعلمات: درجة الحرارة وTop-P والبذلة

تحكم في الإبداع باستخدام temperature و top_p. تعيين temperature إلى 0.7 لمخرجات متوازنة أو 1.5 لمزيد من التنوع. استخدم top_p لتقييد الكتلة الاحتمالية للرموز المأخوذة عينياً. تعيين seed عدد صحيح للحصول على نتائج قابلة للتكرار. تساعدك هذه المعاملات في ضبط النموذج للمهام المحددة.

المعلمات الرئيسية

• temperature: 0.0 إلى 2.0
• top_p: 0.1 إلى 1.0
• seed: أي عدد صحيح

ادمج هذه مع max_tokens للتحكم في الطول. يحترم النموذج حدود نافذة السياق بدقة.

Copyimport OpenAI from "openai";

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

الاستجابات التدفقية وعد الرموز

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

معالجة التدفق

• اقرأ القطع (chunks) عند وصولها
• تحليل الـ delta field
• تحقق usage في القطعة الأخيرة

يعمل البث مع جميع المعلمات. لا يؤثر ذلك على تسعير لكل رمز. تدفع مقابل الرموز الفعلية المولدة.

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)

استدعاء الوظائف ووضع JSON

استخدام tools للاستدعاء الوظيفي أو response_format لإخراج JSON. اضبط response_format إلى {"type": "json_object"} لـ JSON الصارم. تُرجع النموذج بيانات مُهيّأة ومناسبة للتحليل. هذا مفيد لبناء وكلاء أو خطوط أنابيب لاستخراج البيانات.

تكوين

• tools: مصفوفة من تعريفات الوظائف
• response_format: {"type": "json_object"}

تأكد من مطابقة تعليمات موجهك للمخطط. قد لا يزال النموذج يحتاج إلى التحقق. تعامل دائماً مع أخطاء التحليل المحتملة.

مثال على وضع JSON

تعيين response_format لإجبار إخراج JSON الصارم. يقلل هذا من الحاجة إلى المعالجة اللاحقة.

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

نافذة السياق هي 100,000 رمز إجمالاً. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. يمكنك إرسال 300 طلب في الدقيقة لكل مفتاح. يُسمح بثمانية طلبات متزامنة في وقت واحد. تعيد الأخطاء أكواد HTTP قياسية.

الأخطاء الشائعة

• 401: مفتاح غير صالح أو مفقود
• 402: رصيد غير كافٍ
• 429: تم تجاوز حد المعدل

الرفض بسبب حدود المحتوى لا يستهلك الرصيد. الأخطاء لا تستهلك الرصيد أيضاً. رصيدك المدفوع مسبقاً لا ينتهي صلاحيته.

حدود الطلب

حد حجم جسم الطلب الأقصى هو 8 ميجابايت. تجاوز هذا يعيد خطأ 413. أدر استخدام الرموز الخاصة بك بعناية.