البدء السريع: توصيل SDK الخاص بك
استبدل نقطة النهاية الحالية بعنوان URL الأساسي الخاص بنا وأدرج مفتاح API الخاص بك في الرأس. يوجه هذا التبديل البسيط طلباتك إلى النموذج غير الخاضع للرقابة فوراً.
عنوان URL الأساسي هو https://api.geminisenzacensura.com/v1. تعتمد المصادقة على رمز حامل (Bearer) يُمرر في Authorization الرأس. تنشئ هذا المفتاح فورًا بعد التسجيل عبر Google أو البريد الإلكتروني.
- لا حاجة لمكتبات إضافية.
- يعمل مع أي عميل متوافق مع OpenAI.
- توفر فوري عند إنشاء المفتاح.
تتخلص هذه الطريقة من وسطاء الوكلاء والإعدادات المحلية المعقدة.
curl https://api.geminisenzacensura.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the capital of Peru?"}]
}'نقطة النهاية: POST /v1/chat/completions
أرسل تلميحك إلى نقطة إكمال الدردشة للحصول على مخرجات نصية. تتعامل نقطة النهاية هذه مع جميع الاستدلال للنموذج غير الخاضع للرقابة.
حدد معرف النموذج كـ "uncensored" في جسم الطلب. تعيد واجهة برمجة التطبيقات (API) استجابات JSON القياسية التي تحتوي على النص المولد. يمكنك التحكم في السلوك باستخدام معلمات مثل temperature أو top_p.
يدخل الإدخال، يخرج النص. لا تضمين أو توليد صور هنا.
from openai import OpenAI
client = OpenAI(base_url="https://api.geminisenzacensura.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)نقطة النهاية: GET /v1/models
استعلم عن هذا المسار للتحقق من الاتصال وقائمة النماذج المتاحة. يُرجي كائن JSON يحتوي على تفاصيل النموذج.
استخدم هذا لتأكيد أن مفتاح واجهة برمجة التطبيقات الخاص بك لديه الأذونات الصالحة قبل إرسال حمولات البيانات الثقيلة. تؤكد الاستجابة أن معرف النموذج "uncensored" نشط.
هذا فحص خفيف يستهلك الحد الأدنى من الرموز.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.geminisenzacensura.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);المعلمات: درجة الحرارة وTop-p والأدوات
تحكم في العشوائية والهيكلية باستخدام معاملات OpenAI القياسية. اضبط temperature لتنوع إبداعي أو top_p للعينة النواة.
تمكين استدعاء الوظائف بإرسال tools مصفوفة. يدعم النموذج وضع JSON عبر response_format: {"type": "json_object"}. يمكنك أيضًا ضبط stop sequences و seed للتكرار.
تمنحك هذه المعلمات تحكمًا دقيقًا في مخرجات الذكاء الاصطناعي غير الخاضع للرقابة دون الحاجة إلى منطق مخصص.
استجابات البث واستهلاك الرموز
فعّل البث عن طريق تعيين stream: true لتلقي القطع عبر أحداث الإرسال الخادمية (SSE). يقلل هذا من زمن الاستجابة المُدرَك للاستجابات الطويلة.
تحتوي الشريحة النهائية في التدفق على إجمالي استخدام الرموز الشاردية للطلب. يتيح لك ذلك تتبع التكاليف في الوقت الفعلي دون انتظار اكتمال الاستجابة.
يُعد البث المباشر مثاليًا لواجهات الدردشة أو عرض النص التدريجي.
stream = 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)رموز الأخطاء & الحدود
عالج الأخطاء بسلاسة من خلال التحقق من رمز حالة HTTP. A 401 تشير إلى مفتاح API غير صالح أو منتهي الصلاحية. A 402 تعني أن لديك رصيداً مسبقاً غير كافٍ. A 429 إشارة إلى أنك وصلت إلى حد معدل الطلب.
الحد هو 300 طلب في الدقيقة لكل مفتاح. حجم جسم الطلب محدود بـ 8 ميجابايت. لا تستهلك الأخطاء والرفضات رصيدك المدفوع مسبقًا، مما يضمن دفعك مقابل استخدام الرموز الفعلي فقط.
تحقق من جسم الاستجابة (Response Body) للحصول على رسالة خطأ مفصلة لاستكشاف الأخطاء بسرعة.
