توثيق واجهة برمجة التطبيقات

البدء السريع: تغيير base_url

ابدأ بتحديث متغيرين. وجه عميلك إلى https://api.proxyllm.cc/v1 واستخدم المفتاح الذي قمت بإنشائه. تحاكي نقطة النهاية هيكل إكمال الدردشة الخاص بـ OpenAI بدقة. لا تحتاج إلى مكتبات جديدة أو محولات معقدة. فقط قم بتبديل نقطة النهاية والرمز، ثم شغل المنطق الحالي الخاص بك.

Copycurl https://api.proxyllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List five common CSS layout techniques for modern web design."}]
  }'

المصادقة والمفاتيح

أنشئ مفتاحاً عبر لوحة التحكم ومرره في Authorization رأس. يحتوي كل حساب على مفتاح نشط واحد؛ يؤدي إنشاء مفتاح جديد إلى إلغاء سريان القديم. استخدم Bearer your_api_key للطلبات القياسية. يرفض النظام الرموز غير الصالحة على الفور.

نقطة نهاية إكمال الدردشة

أرسل طلبات POST إلى /v1/chat/completions مع مصفوفة الرسائل. معرف النموذج هو uncensored. يتعامل مع توليد النص بدون الرفضات القياسية للمحتوى القانوني للبالغين. اضبط max_tokens للتحكم في طول المخرجات؛ القيمة الافتراضية هي 2,048 رمزاً.

Copyfrom openai import OpenAI

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

البث وأحداث الإرسال الخادم (SSE)

فعّل البث عن طريق تعيين stream: true في حمولة الطلب الخاصة بك. تُعيد واجهة برمجة التطبيقات أحداث مُرسلة من الخادم (SSE) لتسليم الرموز في الوقت الفعلي. تظهر إحصائيات استخدام الرموز في الشريحة الأخيرة من التدفق. يقلل هذا من زمن الاستجابة المُدرَك للاستجابات الكبيرة.

Copyimport OpenAI from "openai";

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

عرّف الأدوات في tools المعامل للإخراج الهيكلي. يدعم النموذج كلًا من استدعاء الوظائف وتنسيق JSON الصارم عبر response_format. استخدم json_object لفرض هياكل JSON صالحة. تتيح معاملات درجة الحرارة (Temperature) و top_p ضبط الإبداع بدقة.

حدود المعدلات والأخطاء

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

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)