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

تثبيت وتكوين SDK

ابدأ بتثبيت مكتبة OpenAI الرسمية للغتك. تعمل واجهة برمجة التطبيقات الخاصة بنا مع أي عميل قياسي متوافق مع OpenAI، لذا لا تحتاج إلى مكتبة مخصصة. اضبط base_url إلى HTTPS://api.ollamaapipricing.com/v1 وتوفير مفتاح API من لوحة حسابك. معرف النموذج هو uncensored. يتعامل هذا النموذج الوحيد مع جميع احتياجاتك لتوليد النصوص دون منطق توجيه.

المصادقة تتطلب مفتاحاً صالحاً. إذا رأيت خطأ 401، فإن مفتاحك غير صالح. إذا رأيت خطأ 402، فلا رصيد لديك. اشحن بـ USDT أو USDC للمتابعة. يضمن عنوان URL الأساسي وصول طلباتك إلى خوادمنا مباشرة.

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

أجرِ طلب POST إلى /v1/chat/completions مع طلبك. يستجيب النموذج بالنص فقط. يمكنك التحكم في طول الاستجابة باستخدام max_tokens. الحد الأقصى الافتراضي للإخراج هو 2,048 رمز ما لم تحدد خلاف ذلك. تدعم نافذة السياق ما يصل إلى 100,000 رمز لكل من المدخلات والمخرجات مجتمعة.

استخدم المثال التالي للتحقق من الاتصال وجودة الاستجابة. اضبط messages مصفوفة لتناسب حالة الاستخدام الخاصة بك.

Copycurl https://api.ollamaapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total cost for 100m tokens"}]
  }'

تمكين التدفق والأدوات

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

تعيين stream إلى true في تكوين SDK الخاص بك. ستصل الاستجابة كسلسلة من القطع. تعامل مع كل قطعة بشكل مناسب في منطق التطبيق الخاص بك. يقلل هذا النهج من زمن الاستجابة المدرك للمستخدمين الذين ينتظرون استجابات طويلة.

Copyfrom openai import OpenAI

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

التعامل مع استجابات وضع JSON

استخدام response_format تعيين إلى {"type": "json_object"} لإجبار إخراج مهيكل. هذا مفيد لتحليل البيانات أو توليد الكود. يلتزم النموذج بمخطط JSON المقدم في النص التوجيهي. إذا كانت المخرجات غير صالحة، قد يفشل الطلب أو يعيد JSON غير صالح.

ادمج وضع JSON مع استدعاء الوظائف لدمج أدوات قوي. تأكد من أن تعليماتك (Prompts) تحدد الهيكل المتوقع بوضوح. يقلل هذا من الحاجة إلى معالجة الأخطاء بعد التنفيذ. لا يتحقق API من هيكل JSON نفسه، لذا اعتمد على تدريب النموذج.

Copyimport OpenAI from "openai";

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

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

التسعير هو $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج. الأخطاء والرفض مجاني. يتم شحن الرصيد فقط لتوليد الرموز الناجحة. الرصيد المسبق لا ينتهي. هذا النموذج غير خاضع للرقابة للاستخدام القانوني للبالغين، مما يعني رفضًا أقل للمواضيع القياسية.

راقب استخدامك عبر قطعة SSE النهائية أو رؤوس استجابة واجهة برمجة التطبيقات. تابع رصيدك لتجنب انقطاع الخدمة. يمكنك الإضافة في أي وقت باستخدام العملات المشفرة. النظام شفاف بشأن التكاليف لكل طلب. لا توجد رسوم خفية.

الحدود والأخطاء

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

عالج الأخطاء بسلاسة. يعني خطأ 401 أن المفتاح غير صالح. يشير خطأ 402 إلى عدم كفاية الرصيد. يعني خطأ 429 أنك مقيد بمعدل الطلبات. لا تقدم الواجهة البرمجية اتفاقيات مستوى الخدمة (SLAs) أو ضمانات وقت التشغيل. خطط لإعادة المحاولة وفقاً لذلك.

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)