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

المتطلبات الأساسية: حزمة التطوير (SDK) ومفتاح API

ابدأ بإنشاء حساب للحصول على مفتاح واجهة برمجة التطبيقات (API key) الفريد. سجّل الدخول باستخدام Google أو البريد الإلكتروني وكلمة المرور لتوليد مفتاح على الفور دون التحقق من رقم الهاتف. ثبّت حزمة مكتبة SDK المفضلة لديك، مثل openai لـ Python، وقم بإعداده بعنوان URL الأساسي https://api.apiaicheapest.com/v1. قم بمصادقة كل طلب عن طريق تعيين Authorization الرأس إلى Bearer YOUR_API_KEY. يمكنك اختبار الاتصال فورًا باستخدام الأمثلة المقدمة.

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

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

Copycurl https://api.apiaicheapest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this Python list to a JSON array"}]
  }'

استجابات البث (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)

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

عرّف الأدوات للسماح للنموذج باستدعاء دوال خارجية ديناميكياً. مرر قائمة من تعريفات الأدوات في tools السماح وحدد tool_choice كـ auto. يعيد النموذج حجت الوظيفة بتنسيق JSON عند الاقتضاء. حلل هذه الحجج في كودك لتنفيذ المنطق المطلوب. تتيح هذه الميزة سير عمل الوكلاء المعقدة ومهام استخراج البيانات.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiaicheapest.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 والمعاملات

فرض إخراج منظم عن طريق تعيين response_format إلى {"type": "json_object"}. يضمن ذلك أن يُعيد النموذج بيانات JSON، وهو أمر حاسم للاستهلاك البرمجي. يمكنك أيضًا التحكم في العشوائية باستخدام temperature و top_p, أو تسلسلات التوقف. اضبط هذه المعلمات لتحقيق التوازن بين الإبداع والدقة. يدعم النموذج نافذة سياق بحجم 100,000 رمز للمستندات الطويلة.

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

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

Python

Copyfrom openai import OpenAI

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