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

المتطلبات المسبقة والمصادقة

تحتاج إلى مفتاح API وعنوان URL الأساسي للبدء. سجّل حسابك في صفحة الحصول على مفتاح API باستخدام Google أو البريد الإلكتروني. يظهر مفتاحك على الفور؛ لا حاجة لبطاقة ائتمان للتجربة. عنوان URL الأساسي هو https://api.ollamansfw.com/v1. اضبط هذا في بيئة التشغيل أو تكوين SDK. معرف النموذج هو uncensored. إنه نموذج مفتوح الأوزان يعمل على خوادمنا، وهو مميز عن GPT أو نماذج البائعين الآخرين.

طلبك الأول

أرسل طلب إكمال دردشة قياسي. تتوقع واجهة API مصفوفة messages تحتوي على role و content. استخدم curl لاختبار الاتصال. استبدل YOUR_API_KEY بمفتاحك الفعلي. تعيد الاستجابة النص المُولّد في choices[0].message.content. إذا حصلت على 401، تحقق من مفتاحك. يعني 402 أنك بحاجة إلى رصيد.

تكامل SDK Python

استخدم حزمة Python الرسمية openai. قم بتثبيتها عبر pip. قم بتكوين العميل باستخدام عنوان URL الأساسي المخصص ومفتاح API. هذا يضمن التوافق مع نقطة النهاية الخاصة بنا. يوضح الكود أدناه توليد نص بسيط. يتعامل مع الطلب ويطبع النتيجة. يجب أن تتضمن معالجة الأخطاء التقاط استثناءات HTTP. يعمل هذا النهج مع أي عميل متوافق مع OpenAI.

تكامل حزمة SDK لـ Node.js

قم بتثبيت حزمة Node.js openai. اضبط عنوان URL الأساسي ومفتاح API في تهيئة العميل. يعكس الهيكل مثال Python. مرر معرف النموذج uncensored. تحتوي الاستجابة على بيانات الإكمال. استخدم async/await للحصول على كود نظيف. هذه الطريقة مثالية لتطبيقات الخادم أو أدوات سطر الأوامر التي تحتاج إلى وصول مباشر إلى واجهة API.

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

فعّل البث المتدفق عن طريق تعيين stream: true. تعيد واجهة API تدفق أحداث يرسلها الخادم (SSE). يحتوي كل جزء على نص جزئي. يتضمن الجزء الأخير إحصائيات استخدام الرموز. هذا يقلل من زمن الاستجابة المدرك للاستجابات الطويلة. تعامل مع أخطاء التدفق بسلاسة. توفر مكتبات SDK مكررات تدفق مدمجة. قم بمعالجة كل جزء لتحديث واجهة المستخدم في الوقت الفعلي.

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

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

cURL

نسخcurl https://api.ollamansfw.com/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

نسخfrom openai import OpenAI

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

نسخimport OpenAI from "openai";

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