توثيق المطور

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

يصادق مفتاح API الخاص بك على كل طلب موجه إلى chat-completions نقطة النهاية. تتلقى هذا المفتاح فورًا بعد التسجيل عبر Google أو البريد الإلكتروني على احصل على مفتاح API صفحة. لا يتطلب رقم هاتف. احفظ مفتاحك بأمان وأمرره في Authorization رأس.

URL الأساسي: https://api.cheapllm.cc/v1. يجب أن تتضمن جميع الطلبات هذا الرأس: Authorization: Bearer YOUR_API_KEY. تشير الأخطاء مثل 401 إلى مفتاح غير صالح أو مفقود. يمكنك استبدال مفتاحك القديم في أي وقت لتوليد مفتاح جديد؛ يوجد مفتاح نشط واحد فقط لكل حساب.

الطلب الأول

أرسل أول موجه باستخدام المعيار chat/completions النقطة النهائية. معرف النموذج هو uncensored. يجيب هذا النموذج مفتوح المصدر دون رفضات المحتوى للاستخدام البالغ القانوني، بما في ذلك المواضيع الخيالية أو المثيرة للجدل. تحصل على مدخلات نصية ومخرجات نصية. لا توجد هنا عمليات تضمين أو توليد صور.

يوضح أدناه مثال cURL أساسي. استبدل YOUR_API_KEY مع المفتاح الخاص بك. يحدد جسم الطلب رسالة المستخدم. نعالج نافذة سياق بحجم 100,000 رمز (طلب + إكمال). الأخطاء والرفضات مجانية، لذا اختبر بحرية.

• تعيين model إلى uncensored.
• تضمين messages مصفوفة.
• أضف رأس مفتاح API الخاص بك.

Copycurl https://api.cheapllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set timezone to UTC for all logs"}]
  }'

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

استخدم مكتبة Python SDK الرسمية من OpenAI للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا. اضبط عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا وقدم مفتاحك. تعمل هذه الطريقة مع أي مكتبة عميل متوافقة مع OpenAI. قم بتكوين المعلمات مثل temperature و top_p حسب الحاجة. يدعم البث عبر أحداث الحدث الخادم (SSE). هذه الطريقة مثالية للتطبيقات في الوقت الفعلي حيث تريد عرض الرموز المميزة أثناء توليدها.

ثبّت المكتبة باستخدام pip install openai. قم بتهيئة العميل باستخدام عنوان URL الأساسي الخاص بنا. يُظهر الكود أدناه طلب إكمال بسيط. اضبط محتوى الرسالة ليناسب حالة الاستخدام الخاصة بك. يتعامل الـ API الخاص بنا مع التوجيه إلى النموذج الصحيح داخلياً.

Copyfrom openai import OpenAI

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

تكامل Node SDK

بالنسبة لمطوري Node.js، تعمل حزمة npm الخاصة بـ OpenAI بسلاسة. قم بتعيين عنوان URL الأساسي إلى نقطة نهاية واجهة برمجة التطبيقات الخاصة بنا. هذا يسمح لك باستخدام الأنماط المألوفة من مزودي آخرين. قم بتعيين معرف النموذج إلى uncensored. يمكنك أيضًا تمكين وضع JSON أو استدعاء الوظائف إذا كانت تطبيقك يتطلب إخراجًا مهيكلاً. يتعامل SDK مع المصادقة تلقائيًا عند تكوينه بشكل صحيح.

ثبّت الحزمة باستخدام npm install openaimax_tokens للتحكم في طول المخرجات. تُرجع الأخطاء كرموز حالة HTTP قياسية. استخدم هذا للتجريب السريع أو تكاملات الإنتاج.

Copyimport OpenAI from "openai";

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

استجابات البث عبر SSE

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

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

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)

حدود، أخطاء، ونافذة السياق

لدينا حدود صارمة لضمان الاستقرار. يمكنك إرسال 300 طلب في الدقيقة لكل مفتاح. الطلبات المتزامنة مقيدة بـ 8. لا يمكن أن تتجاوز أحجام الطلبات 8 ميجابايت. نافذة السياق هي 100,000 رمز إجمالاً. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب (2,048 إذا max_tokens غير مضبوط). تُرجع الأخطاء رموزًا محددة: 401 للمفاتيح غير الصالحة، و402 لعدم كفاية الرصيد، و429 لحدود معدل الطلب. لا تنتهي صلاحية الرصيد. الأخطاء مثل الشحن المزدوج تُصلح عبر الدعم. الخصوصية محفوظة؛ لا تُستخدم المدخلات للتدريب. لا يُسمح بمحتوى جنسي يتضمن قاصرين.