بداية سريعة: ربط عميلك
أرسل طلبات إلى https://api.isgeminiuncensored.com/v1 باستخدام SDKs القياسية من OpenAI. تعمل خدمتنا كبديل جاهز للاستخدام لمقدمي الخدمات الآخرين، لذا تحتاج فقط إلى تحديث عنوان URL الأساسي وتقديم مفتاح API الخاص بك. يمكنك إنشاء المفتاح على الفور عبر لوحة التحكم باستخدام Google أو البريد الإلكتروني. يلغي هذا الإعداد الحاجة إلى الوكيل المعقد أو أوامر الاختراق المخصصة.
المصادقة تعتمد على مفتاح API نشط واحد لكل حساب. إذا أنشأت مفتاحاً جديداً، يصبح المفتاح السابق غير صالح فوراً. هذا يضمن تحكماً صارماً في استخدامك مع الحفاظ على خصوصية بياناتك. لا تُستخدم نصوصك في التدريب، لذا تبقى أعمالك الإبداعية ملكاً لك.
الطلب الأول: مثال cURL
تحقق من اتصالك عن طريق إرسال طلب إكمال نصي بسيط. استخدم نقطة نهاية إكمال الدردشة القياسية مع معرف النموذج uncensored. ستعيد الاستجابة النص المُولّد بناءً على مدخلاتك دون الرفض القياسي للمحتوى.
يؤكد هذا الاختبار الأساسي أن مفتاحك صالح وأن نقطة النهاية قابلة للوصول. يمكنك بعد ذلك دمج هذا النمط في منطق تطبيقك. يعكس هيكل الاستجابة تنسيق OpenAI، مما يضمن التوافق مع معظم الأدوات الموجودة.
curl https://api.isgeminiuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top five Linux commands for network troubleshooting."}]
}'ابدأ بطلبات بسيطة للتحقق من جودة المخرجات. يمكنك بعد ذلك التوسع إلى تفاعلات أكثر تعقيدًا عند الحاجة. يتولى النظام الجزء الشاق من إدارة السياق نيابة عنك.
تكامل واجهة برمجة تطبيقات Python
استخدم مكتبة Python الرسمية لدمج واجهة برمجة التطبيقات الخاصة بنا في سكربتاتك. اضبط عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا وقم بتوفير مفتاح API الخاص بك. يتيح لك هذا النهج الاستفادة من قواعد الشيفرة الحالية بتغييرات قليلة. يمكنك استخدام التدفق أو المكالمات المتزامنة حسب احتياجاتك.
تتعامل مكتبة SDK الخاصة بـ Python مع تسلسل طلباتك تلقائيًا. يمكنك تمرير معاملات مثل درجة الحرارة وtop_p للتحكم في المخرجات. يمنحك هذا المرونة ضبط سلوك النموذج ليناسب حالة الاستخدام المحددة الخاصة بك. سواء كنت تبني روبوت محادثة أو أداة تحليل، فإن مكتبة SDK تُبسط العملية.
from openai import OpenAI
client = OpenAI(base_url="https://api.isgeminiuncensored.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)تأكد من معالجة كائنات الاستجابة بشكل صحيح. يُعيد SDK بيانات منظمة يمكنك تحليلها بسهولة. هذا يجعل التصحيح والاختبار أمرين straightforward. يمكنك أيضاً استخدام العملاء غير المتزامين للتطبيقات عالية الإنتاجية.
تكامل Node SDK
قم بالتكامل مع تطبيقات Node.js باستخدام حزمة npm الرسمية من OpenAI. وجه العميل إلى عنوان URL الأساسي الخاص بنا وحدد مفتاح واجهة برمجة التطبيقات. يتيح لك ذلك استخدام الأنماط المألوفة في مشاريع جافا سكريبت. يمكنك إجراء طلبات متزامنة أو غير متزامنة بسهولة.
يدعم SDK لـ Node ميزات JavaScript الحديثة مثل الوعود وasync/await. هذا يجعل معالجة الأخطاء والاستجابات نظيفة. يمكنك تمرير نفس المعلمات كما في SDK Python لضبط سلوك النموذج. يقلل هذا الاتساق عبر اللغات من منحنى التعلم للفرق التي تستخدم تقنيات متعددة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.isgeminiuncensored.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);اختبر تكاملك باستعلام بسيط. ستؤكد الاستجابة أن إعدادك صحيح. يمكنك بعد ذلك المضي قدمًا في بناء تفاعلات أكثر تعقيدًا. يتعامل SDK مع طلبات HTTP بكفاءة، مما يضمن زمن استجابة منخفض.
استجابات البث
فعّل التدفق عن طريق تعيين stream parameter إلى 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)التعامل مع انقطاعات الشبكة بسلاسة. يمكن إيقاف التدفق أو استئنافه اعتماداً على قدرات عميلك. يضمن هذا المرونة تجربة مستخدم سلسة حتى على الاتصالات غير المستقرة. يمكنك إيقاف التدفق مبكراً إذا غيّر المستخدم مدخلاته.
حدود، أخطاء، والسياق
يحتوي حسابك على حد معدل 300 طلب في الدقيقة و 8 طلبات متزامنة لكل مفتاح. إذا تجاوزت هذا الحد، ستتلقى خطأ 429. يمكنك مراقبة استخدامك من لوحة التحكم لتجنب الانقطاعات. يضمن هذا الحد وصولاً عادلاً لجميع المستخدمين.
يدعم نطاق السياق ما يصل إلى 100,000 رمز للطلب والإكمال معاً. يمكنك تحديد حد أقصى للإخراج يبلغ 16,000 رمز لكل طلب. إذا لم تحدد حداً، فإن الافتراضي هو 2,048 رمز. لا تستهلك الأخطاء والرفض رصيدك المدفوع مسبقاً.
تشمل الأخطاء الشائعة 401 للمفاتيح غير الصالحة و402 لقصور الرصيد. يمكنك الشحن بالعملات المشفرة فقط. USDT على TRC20 أو USDC على Base مقبول. الأخطاء مثل الشحن المزدوج يتم إصلاحها عبر الدعم. رصيدك المدفوع مسبقًا لا ينتهي صلاحيته أبدًا، لذا يمكنك الشحن بالسرعة التي تناسبك. يضمن هذا الهيكل أن تكون التكاليف قابلة للتنبؤ وشفافة.
