وثائق واجهة برمجة التطبيقات (API) للمطورين

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

عنوان URL الأساسي هو HTTPS://api.ollamaapiurl.com/v1. تقوم بالمصادقة من خلال تمرير مفتاح API الفريد الخاص بك في رأس المصادقة. يعمل هذا المفتاح كجواز سفر لجميع الطلبات. احصل عليه من لوحة التحكم الخاصة بك مباشرة بعد التسجيل.

• حافظ على أمان مفتاحك. يمنحك الوصول الكامل إلى رصيدك المدفوع مسبقًا.
• أنشئ مفتاحاً جديداً في أي وقت من صفحة الإعدادات.

نظام مفتاح الـ API الخاص بنا بسيط. مفتاح نشط واحد لكل حساب يضمن تتبعاً واضحاً. إذا فقدت الوصول، يمكنك تجديده فوراً. لا توجد حاجة للتحقق عبر رقم الهاتف لعرقلة دخولك.

الطلب الأول

أرسل أول موجه باستخدام HTTP القياسي. تقبل نقطة النهاية إدخال النص وتعيد مخرجات نصية. تعمل هذه الطريقة مع أي مكتبة عميل HTTP تفضلها.

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

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

تكامل مكتبة Python

استخدم مكتبة بايثون الرسمية من OpenAI. وجهها إلى عنوان URL الأساسي الخاص بها. اضبط معرف النموذج على uncensored. يضمن ذلك الحصول على سلوك غير خاضع للرقابة دون متاعب الإعداد المحلي.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ollamaapiurl.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 منظم أو نص خام. التدفق مدعوم أيضًا. يحافظ هذا النهج على نظافة الكود وقابليته للصيانة.

إعداد Node SDK

ثبّت الحزمة openai. اضبط عنوان URL الأساسي ليشير إلى خدمتنا. اضبط مفتاح API من بيئتك. يعكس هذا الإعداد تكوين Python عن كثب.

Copyimport OpenAI from "openai";

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

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

استجابات البث

فعّل التدفق عن طريق تعيين stream إلى true. تُعيد واجهة برمجة التطبيقات أجزاءً بمجرد توليدها. يحسن هذا من زمن الاستجابة المُدرَك للمستخدمين. يمكنك عرض الرموز عند ظهورها.

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 رمز إجماليًا. يشمل ذلك كلًا من الطلب والإكمال. يمكنك إخراج ما يصل إلى 16,000 رمز لكل طلب. يسمح حد معدل الطلب بإجراء 300 طلب في الدقيقة. الحد الأقصى للطلبات المتزامنة هو ثمانية لكل مفتاح.

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