ابدأ بواجهتنا البرمجية غير الخاضعة للرقابة

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

وجّه حزمة تطوير البرمجيات (SDK) الخاصة بك إلى نقطة النهاية لدينا ومرر مفتاحك في رأس المصادقة. نقدم عنوان URL أساسي مستضافاً واحداً يعمل مع أي عميل متوافق مع OpenAI. تحصل على مفتاح نشط واحد لكل حساب، ويستغرق التسجيل ثوانٍ عبر Google أو البريد الإلكتروني دون الحاجة إلى رقم الهاتف. يمنحك المفتاح الوصول إلى النموذج غير الخاضع للرقابة فوراً عند إنشائه.

المصادقة تعتمد على رموز حامل قياسية. إذا أرسلت مفتاحاً غير صالح، تُرجع API خطأ 401. يمكنك إنشاء مفتاح جديد في أي وقت، ويتوقف العمل بالمفتاح القديم فوراً. يحافظ هذا التصميم على خصوصية استخدامك ويبسط وصولك.

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

نقطة نهاية إكمال الدردشة (POST /v1/chat_completions)

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

واجهة برمجة التطبيقات (API) الخاصة بنا صارمة بشأن ما تفعله. لا ندعم التضمينات (embeddings) أو توليد الصور أو معالجة الصوت. تحصل على نص مدخلات ونص مخرجات. تدعم نافذة السياق 100,000 رمز لكل من الطلب والإكمال معًا. هذا يسمح بمحادثات طويلة أو معالجة مستندات كبيرة.

حافظ على طلباتك نظيفة ومهيكلّة. تتوقع النهاية تنسيق JSON محدد. إذا أرسلت نوع بيانات خاطئ، ستتلقى خطأ. نحن نتولى الجزء الأكبر من الاستدلال على خوادمنا الخاصة.

مثال على تكامل مكتبة Python

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

يعمل هذا لأن واجهة برمجة التطبيقات الخاصة بنا متوافقة تمامًا مع OpenAI. لا تحتاج إلى مكتبة عميل مخصصة. فقط قم بتحديث عنوان URL الأساسي ومفتاح API الخاص بك. تظل ميزات المكتبة الأخرى كما هي. يجعل هذا الترحيل من مزودي الخدمات الآخرين مباشرًا إذا احتجت إلى التبديل لاحقًا.

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

مثال تكامل Node SDK

قم بالتكامل مع Node.js باستخدام حزمة npm القياسية. يتطابق الهيكل مع مثال Python. تقوم بتعيين عنوان URL الأساسي إلى نقطة النهاية الخاصة بنا وتقديم مفتاح واجهة برمجة التطبيقات. يضمن ذلك التوافق مع تطبيقات Node.js الموجودة.

يتعامل SDK لـ Node مع طلبات HTTP تلقائياً. تمرر مصفوفة الرسائل وتتلقى كائن الاستجابة. يتضمن ذلك محتوى النص المولد. يمكنك بعد ذلك معالجة هذا النص في منطق التطبيق الخاص بك.

تذكر أننا ندعم إكمال النص فقط. لا تتوقع بيانات الصور أو الصوت في الاستجابة. ستقوم مكتلة SDK بتحليل استجابة JSON ومنحك الوصول إلى النص. يبسط هذا الاتساق عبر اللغات عملية التطوير الخاصة بك.

الاستجابات التدفقية واستخدام الرموز

تمكين التدفق لتلقي استجابة الرمز رمزًا تلو الآخر. يوفر هذا زمن استجابة أسرع مُدرَكًا للمستخدمين. يمكنك عرض النص أثناء توليده بدلاً من انتظار الاستجابة الكاملة. هذا أمر حاسم لواجهات الدردشة.

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

تدعم واجهة برمجة التطبيقات الخاصة بنا أحداث Server-Sent للتدفق. تتعامل مكتبة SDK مع تحليل الأحداث. كل ما عليك هو ضبط المعلمة stream إلى true. يعمل هذا مع عملاء Python و Node. إنه الطريقة الموصى بها لبناء التطبيقات التفاعلية.

حدود، أخطاء، وتفاصيل النموذج

فهم حدود المعدلات والأخطاء المحتملة لبناء تطبيق قوي. أنت مقيد بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. حجم جسم الطلب مقيد بـ 8 ميجابايت. إذا تجاوزت هذه الحدود، ستتلقى خطأ 429. يمكنك تنفيذ تراجع أسي للتعامل مع هذا بسلاسة.

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

يمكنك التحقق من النماذج المتاحة عبر نقطة النهاية GET /v1/models. سيؤدي ذلك إلى إرجاع معرف النموذج uncensored الوحيد. لا نقدم نماذج متعددة أو توجيهاً. يقلل هذا البساطة من التعقيد ويضمن سلوكاً متسقاً. لا ينتهي صلاحية رصيدك المدفوع مسبقاً، لذا يمكنك إيقاف الاستخدام دون فقدان الأموال.

cURL

Copycurl https://api.keyapiunlimited.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the python libraries for web scraping"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

التدفق

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)