البدء السريع لواجهة برمجة التطبيقات Ollama Abliterated

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

قم بتكوين العميل مع عنوان URL الأساسي المقدم ومفتاح API لبدء الطلبات. نقطة النهاية هي HTTPS://api.ollamaabliterated.com/v1 ويجب عليك تمرير مفتاحك في رأس المصادقة كرمز حامل. يعمل هذا الإعداد مع أي SDK متوافق مع OpenAI عن طريق تجاوز عنوان URL الأساسي الافتراضي.

Copycurl https://api.ollamaabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the system prompt to relaxed mode"}]
  }'

سجّل عبر Google أو البريد الإلكتروني على لوحة التحكم للحصول على مفتاحك فورًا.

طلب إكمال الدردشة الأساسي

أرسل طلب POST إلى /v1/chat/completions مع معرف النموذج "uncensored" لتلقي استجابات نصية. يعمل النموذج دون رفض المحتوى للمحتوى البالغ القانوني، ويتعامل مع المواضيع المثيرة للجدل أو NSFW مباشرة. يمكنك التحكم في السلوك باستخدام معلمات مثل درجة الحرارة وtop_p.

Copyfrom openai import OpenAI

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

يستهلك كل طلب رموز مدخلات للمطالبة ورموز مخرجات للاستجابة المُولّدة. لا تستهلك الأخطاء والرفض رصيدك.

استجابات البث عبر SSE

فعّل التدفق عن طريق تعيين 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)

عالج حدث نهاية التدفق لإنشاء مخزن الاستجابة الخاص بك وتسجيل حسابات الرموز لتتبع التكاليف.

استدعاء الوظائف ودعم الأدوات

عرّف الأدوات في طلبك لتمكين قدرات استدعاء الوظائف داخل النموذج غير الخاضع للرقابة. تدعم الواجهة البرمجية tool_choice وتمرر تعريفات الأدوات بتنسيق OpenAI القياسي. هذا يسمح باستخراج البيانات المهيكلة أو تشغيل الإجراءات دون الحاجة إلى منطق تحليل خارجي.

Copyimport OpenAI from "openai";

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

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

تكوين وضع JSON

فرض إخراج JSON صارم عن طريق تعيين response_format إلى {"type": "json_object"} في حمولة طلبك. هذا الوضع مثالي لتحليل البيانات المنظمة من LLM دون معالجة لاحقة باستخدام التعبيرات النمطية (regex). يضمن أن تتبع الاستجابة صيغة JSON صالحة في كل مرة.

استخدم هذا لتوليد ملفات التكوين، حمولات واجهة برمجة التطبيقات، أو السجلات المهيكلة. اجمعها مع قيم درجة حرارة عالية إذا كنت تحتاج إلى تنوعات JSON إبداعية.

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

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

تدعم نافذة السياق إجمالي 100,000 رمز، مع حد أقصى للإخراج يبلغ 16,000 رمز لكل طلب. يجب أن تبقى أحجام الطلبات أقل من 8 ميجابايت. لا يتم إصدار استرداد للرصيد، لكن الشحنات المزدوجة يتم حلها عبر الدعم.