أول طلب في خمس دقائق

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

وجّه مكتبة OpenAI SDK أو أي عميل متوافق إلى عنوان URL الأساسي الخاص بنا. لا تحتاج إلى مكتبة محددة؛ أي أداة تقبل مفتاح API قياسي تعمل هنا. احصل على مفتاحك من لوحة التحكم بعد تسجيل الدخول باستخدام Google أو البريد الإلكتروني. يظهر المفتاح فورًا وهو الاعتماد الوحيد المطلوب لجميع الطلبات.

عيّن عنوان URL الأساسي إلى https://api.ollamaapi.top/v1. استخدم معرف النموذج uncensored لجميع إكمالات الدردشة. هذا النموذج مفتوح الأوزان، ومُضبط لرفض أقل، ومختلف عن نماذج كبار الموردين. إنه ليس GPT أو Claude أو أي نموذج مملوك لجهة أخرى. يعتمد المصادقة فقط على رأس Bearer token.

أول طلب

أرسل طلب إكمال دردشة قياسي لاختبار الاتصال. تقبل نقطة النهاية حمولات JSON مع messages، model، ومعاملات اختيارية مثل temperature أو max_tokens. معرف النموذج هو دائمًا uncensored. تعود الاستجابات بـ JSON منظم يتضمن محتوى المساعد ومقاييس استخدام الرموز.

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

Copycurl https://api.ollamaapi.top/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 SDK

استخدم مكتبة Python الرسمية لـ OpenAI أو أي عميل متوافق. قم بتهيئة العميل بعنوان URL الأساسي ومفتاح API الخاص بك. اضبط النموذج على uncensored. مرر رسائلك كقائمة من القواميس تحتوي على role و content. تتعامل المكتبة مع التسلسل وتحليل الاستجابة تلقائيًا.

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

Copyfrom openai import OpenAI

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

قم بتثبيت حزمة npm openai أو استخدم أي غلاف يعتمد على fetch. قم بتهيئة العميل بعنوان URL الأساسي https://api.ollamaapi.top/v1 ومفتاح API الخاص بك. يبقى معرف النموذج uncensored. مرر جسم الطلب مع messages وإعدادات اختيارية مثل top_p أو seed.

يمكن لمستخدمي Node.js الاستفادة من أنماط async/await للحصول على كود نظيف. يتضمن كائن الاستجابة choices، وusage، وid. يمكنك استخراج رسالة المساعد من الخيار الأول. يجب أن يأخذ التعامل مع الأخطاء في الاعتبار حدود المعدل (429) وقلة الرصيد (402). هذه الأخطاء لا تستهلك الرموز، لذا يبقى رصيدك المسبق الدفع سليماً حتى يتم توليد استجابة ناجحة.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaapi.top/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). تحتوي كل شريحة على محتوى جزئي، مما يتيح لك عرض الرموز أثناء إنشائها. يقلل هذا من زمن الاستجابة المدرك للمستخدمين ويحسن تجربة توليد النصوص طويلة المدى.

يشمل الجزء الأخير من البث بيانات استخدام الرموز الكاملة. يمكنك استخدام ذلك لتتبع الاستهلاك في الوقت الفعلي. لاحظ أن البث لا يغير نموذج التسعير؛ لا تزال تدفع مقابل 1M رمز إدخال وإخراج. الأخطاء أثناء البث مجانية أيضًا. إذا انقطع الاتصال، يمكنك استئناف الطلب أو إعادة تشغيله دون عقوبة.

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)

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

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