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

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

تعيش واجهة برمجة التطبيقات عند https://api.ollamauncensoredmodels.com/v1المصادقة رأس مع رمز Bearer الخاص بك. يعمل هذا الإعداد مع أي مكتبة عميل متوافقة مع OpenAI لأننا نلتزم بأنماط المصادقة نفسها. يمكنك إنشاء مفتاحك فوراً عبر Google أو البريد الإلكتروني دون تقديم رقم هاتف. يصدر النظام مفتاحاً نشطاً واحداً لكل حساب، ويستبدل أي مفتاح سابق فوراً عند إنشائه. يضمن هذا وصولاً متسقاً دون الحاجة إلى إدارة بيانات اعتماد متعددة في وقت واحد.

إجراء أول طلب

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

Copycurl https://api.ollamauncensoredmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the output for 2 plus 2"}]
  }'

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

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

Copyfrom openai import OpenAI

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

استخدام SDK Node.js

قم بتهيئة عميل OpenAI بعنوان URL الأساسي ومفتاح API في بيئات Node.js. مرر معرف النموذج "uncensored" إلى طريقة إكمال الدردشة. تدير حزمة SDK طلبات HTTP وتحلل استجابات JSON بكفاءة. يمكنك دمج هذا مباشرة في مسارات Express أو الوظائف الخالية من الخوادم. يعكس هيكل الكود تطبيقات OpenAI القياسية، مما يجعل الانتقال من مزودي الخدمات الآخرين أمرًا مباشرًا. يحافظ هذا النهج على سلامة الأنواع ومعالجة الأخطاء بما يتماشى مع تطوير JavaScript الحديث.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamauncensoredmodels.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 في طلبك. يعيد الخادم أحداث خادم المراسلة (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)

حدود، أخطاء، والسياق

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