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

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

يتمتّع الـ API لدينا بتوافق كامل مع OpenAI. للتبديل، قم بتحديث إعدادات العميل ليُشير إلى عنوان URL الأساسي الخاص بنا وقم بتوفير مفتاح API الخاص بك. عنوان URL الأساسي هو https://api.llminferenceapi.com/v1. تتم المصادقة عبر رأس الـ Authorization: Bearer القياسي. تحصل على المفتاح فوراً بعد إنشاء حسابك باستخدام البريد الإلكتروني وكلمة المرور فقط—لا يتطلب الأمر رقم هاتف أو بطاقة ائتمان للحصول على التجربة المجانية.

• عنوان URL الأساسي: https://api.llminferenceapi.com/v1
• رأس: Authorization: Bearer YOUR_API_KEY
• معرف النموذج: uncensored

يعمل هذا الإعداد مع أي SDK رسمي لـ OpenAI أو مكتبة عميل متوافقة. تحتفظ بهيكل الكود الحالي الخاص بك؛ يتغير فقط نقطة النهاية والمفتاح.

الطلب الأول

أرسل أول طلب إلى نقطة النهاية الخاصة بإكمال الدردشة. معرف النموذج هو uncensored. هذا النموذج هو نموذج لغوي كبير مفتوح الأوزان مُضبط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين، وليس GPT أو Claude.

Copycurl https://api.llminferenceapi.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."}]
  }'

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

تكامل SDK لـ Python

استخدام SDK لـ Python أمر مباشر. قم بتهيئة العميل باستخدام عنوان URL الأساسي الخاص بنا ومفتاح API الخاص بك. يعكس هيكل الكود النمط القياسي لـ OpenAI. يتيح لك هذا استبدال خدمة llm proxy الخاصة بنا دون إعادة كتابة منطق التطبيق.

Copyfrom openai import OpenAI

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

تأكد من تمرير الوسيطة model='uncensored'. يحتوي كائن الاستجابة على النص المولد ومقاييس الاستخدام. هذا النهج مثالي للمطورين الذين يريدون حل openai compatible api جاهز للاستخدام. لا توجد تبعيات إضافية مطلوبة بالإضافة إلى SDK القياسي.

استخدام SDK لـ Node.js

لمطوري Node.js، التكامل بسيط بنفس القدر. قم بتعيين baseURL و apiKey في تكوين العميل. يتعامل SDK مع طلبات HTTP إلى نقاط نهاية ai chat api الخاصة بنا تلقائيًا.

Copyimport OpenAI from "openai";

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

استدعاء chat.completions.create() بمعرف النموذج uncensored. يمكنك تفعيل البث المتدفق للاستجابات أو التعامل معها ككائنات كاملة. يدعم هذا المرونة كلًا من المعالجة الدفعية وتفاعلات المستخدمين في الوقت الفعلي. تدعم الواجهة استدعاء الدوال، مما يتيح لك تعريف الدوال التي يمكن للنموذج استدعاؤها.

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

لتجارب المستخدم في الوقت الفعلي، فعّل البث المتدفق. قم بتعيين المعلمة 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)

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

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

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

تشمل الأخطاء الشائعة 401 (مفتاح غير صالح)، و402 (عدم كفاية الرصيد)، و429 (حدّ المعدل). لا ينتهي الرصيد المسبق الدفع أبداً، لذا يمكنك شحن الرصيد في الوقت الذي يناسبك. يبدأ رصيد مسبق الدفع من 10 دولارات أمريكية، مع مكافآت للإيداعات الأكبر. يضمن هذا النموذج pay as you go ai api أن تدفع فقط مقابل ما تستخدمه.