البدء السريع لمستخدمي Ollama

المتطلبات المسبقة

لاستخدام هذه الواجهة، تحتاج إلى حساب نشط ومفتاح API صالح. سجّل في صفحة الحصول على مفتاح API باستخدام Google أو البريد الإلكتروني وكلمة المرور. لا يلزم رقم الهاتف. تحتاج أيضًا إلى تثبيت SDK لغة مدعوم على جهازك. يغطي هذا الدليل Python وNode.js، وهي أكثر العملاء شيوعًا لنقاط النهاية المتوافقة مع OpenAI. تقدم الواجهة نموذجًا واحدًا بدون رقابة يُعرّف بـ uncensored. تقبل النص وتعيد النص. لا توجد ميزات تضمين أو صور أو صوت. تذهب جميع الطلبات إلى https://api.ollamaapi.cc/v1.

تثبيت SDK

ثبّت الـ SDK الرسمي للغة المفضلة لديك. بالنسبة لـ Python، استخدم pip. بالنسبة لـ Node.js، استخدم npm. تتعامل هذه المكتبات مع بروتوكول HTTP وتحويل JSON والبث تلقائيًا. لا تحتاج إلى كتابة طلبات HTTP الخام ما لم تفضل هذا المستوى من التحكم. الـ SDKs موثقة جيدًا وتُستخدم على نطاق واسع في بيئات الإنتاج. تأكد من مطابقة بيئة عملك لمتطلبات الـ SDK. يُنصح بـ Python 3.8+ وNode.js 18+. حافظ على تحديث التبعيات لتجنب مشكلات التوافق مع معلمات النموذج الأحدث.

تكوين العميل

عيّن عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا. هذا هو التغيير الوحيد في التكوين المطلوب للانتقال من OpenAI إلى خدمتنا بدون رقابة. مرر مفتاح API الخاص بك كعنوان تفويض. سيتولى الـ SDK الباقي. لا تغير اسم النموذج إلى gpt-4 أو ما شابه؛ استخدم uncensored. تتبع الواجهة بروتوكول OpenAI chat-completions بدقة. أي عميل يعمل مع OpenAI سيعمل هنا بهذين التغييرين فقط. يجعل هذا الترحيل أو اختبار A/B أمرًا مباشرًا. يمكنك تشغيل كلتا الواجهتين جنبًا إلى جنب لمقارنة المخرجات.

إرسال الطلب الأول

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

الاستجابات المتدفقة

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

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

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

cURL

Copycurl https://api.ollamaapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

البث المتدفق

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)