مستندات واجهة برمجة تطبيقات إكمال الدردشة غير الخاضعة للرقان

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

يصادق مفتاح واجهة برمجة التطبيقات (API) على طلباتك. تتلقى مفتاحًا واحدًا لكل حساب، تقوم بإنشائه فورًا بعد تسجيل الدخول عبر Google أو البريد الإلكتروني. استخدم عنوان URL الأساسي HTTPS://api.ollamaopenaiapi.com/v1 لتوجيه حركة المرور الخاصة بك.

• انسخ مفتاحك من لوحة التحكم.
• حدد متغير البيئة أو مرره مباشرةً في تكوين العميل.
• تأكد من أن عميلك يشير إلى عنوان URL الأساسي المحدد لدينا لتجنب نقاط النهاية القياسية لـ OpenAI.

نقطة نهاية إكمال الدردشة

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

Copycurl https://api.ollamaopenaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list open ports on this server"}]
  }'

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

Models List Endpoint

استعلم عن قائمة النماذج للتحقق من التوفر. تؤكد الاستجابة معرّف النموذج ونوعه. يُعد هذا الأمر مفيدًا لتصحيح تكوينات العميل. يُرجي تنسيق OpenAI القياسي. استخدم GET /v1/models للفحص. القائمة صغيرة لأننا نقدم نموذجًا رئيسيًا واحدًا. تحقق من هذا المسار لضمان تعرف العميل الخاص بك على هيكل نقطة النهاية.

التدفق و  استخدام الرموز

فعّل البث عن طريق تعيين stream: true. تتلقى أحداث Server-Sent (SSE). يظهر استخدام الرموز في الشريحة الأخيرة. هذا يقلل من زمن الانتظار المُدرَك للمخرجات الطويلة. يمكنك معالجة الرموز عند وصولها. هذا مثالي لواجهات الدردشة. تُرجع API بيانات الاستخدام بدقة. راقب عدد الرموز لإدارة التكاليف. يعمل البث مع جميع المعلمات. يدعم الأدوات ووضع JSON.

المعلمات: درجة الحرارة وTop P والأدوات

تحكم في الإبداع باستخدام temperature و top_p. استخدم tools للاستدعاء الوظيفي. اضبط response_format إلى {"type": "json_object"} لمخرجات مُهيّأة. تتبع هذه المعلمات مخطط OpenAI. يمكنك أيضًا ضبط stop sequences و seed للتكرار. اضبط العقوبات للتحكم في التكرار. يحترم النموذج غير الخاضع للرقابة هذه القيود. لا يفرض نمطاً محدداً. لديك تحكم كامل في التوليد.

معالجة الأخطاء & الحدود

التعامل مع الأخطاء من خلال التحقق من رموز حالة HTTP. يعني 401 مفتاحاً غير صالح. يشير 402 إلى عدم كفاية الرصيد. يشير 429 إلى تحديد المعدل. الحد هو 300 طلب في الدقيقة. التزامن مقصور على 8 طلبات لكل مفتاح. يجب أن يكون حجم جسم الطلب أقل من 8 ميجابايت. لا تستهلك الأخطاء الرصيد. تحقق من جسم الاستجابة للحصول على التفاصيل. يجب أن يتعامل منطق إعادة المحاولة مع أخطاء 429. استخدم التخلف الأسي للموثوقية.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

التدفق

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)