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

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

تتطلب واجهة برمجة التطبيقات مفتاح API صالحًا و SDK حديثًا. قم بتثبيت المكتارة للغتك المفضلة عبر pip أو npm. ندعم مكتبات عميل OpenAI القياسية التي تتعامل مع المصادقة وتحليل JSON تلقائيًا.

تأكد من تثبيت Python 3.8+ أو Node.js 18+. تدير SDKs ربط الاتصال ومنطق إعادة المحاولة لك. هذا يقلل بشكل كبير من كود القالب.

Copyfrom openai import OpenAI

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

تكوين عنوان URL الأساسي ومفتاح API

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

لا تستخدم عنوان URL الأساسي الافتراضي لـ OpenAI. سيفشل مفتاحك إذا تم توجيهه بشكل غير صحيح. اضبط عنوان URL الأساسي في كائن تكوين SDK الخاص بك قبل إرسال أي بيانات.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

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

أرسل طلب POST إلى /v1/chat/completions. قم بتضمين معرف النموذج ومصفوفة الرسائل. يستجيب النموذج بمحتوى نصي على الفور. لا توجد حاجة لمنطق توجيه معقد.

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

Copyimport OpenAI from "openai";

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

معالجة استجابات التدفق واستخدام الأدوات

فعّل التدفق عن طريق تعيين 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 رمز. هذا يشمل رموز الإدخال والإخراج. اضبط max_tokens لتقييد طول الاستجابة. الحد الأقصى الافتراضي للإخراج هو 2,048 رمز إذا لم يتم تحديده.

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

استكشاف الأخطاء الشائعة

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

يشير خطأ 429 إلى تحديد المعدل. أنت مقيد بـ 300 طلب في الدقيقة. قلل من التزامن الخاص بك أو انتظر قبل إعادة المحاثة. يؤدي تجاوز حد جسم 8 ميجابايت أيضاً إلى أخطاء 400.