البدء السريع: قم بدمج الـ واجهة برمجة التطبيقات غير الخاضعة للرقابة

المتطلبات الأساسية: حزمة التطوير (SDK) وإعداد البيئة

ثبّت الحزمة الرسمية (SDK) الخاصة بلغتك. نحن ندعم أي openai عميل متوافق. تعمل خدمتنا كبديل جاهز للتكامل مع تكاملات OpenAI القياسية.

قم بتعيين متغيرات البيئة الخاصة بك على الفور. يتجنب ذلك تخزين بيانات الاعتماد بشكل ثابت في ملفات المصدر الخاصة بك. يحدد مفتاح API الخاص بك حسابك ويتتبع الاستخدام.

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

المصادقة: ضبط مفتاح API

مرر مفتاحك عبر Authorization الرأس. نطلب رمز حامل (Bearer token) لكل طلب. هذه الطريقة قياسية عبر جميع نقاط النهاية المتوافقة مع OpenAI.

أنشئ مفتاحك من لوحة التحكم. تتلقى مفتاحاً نشطاً واحداً لكل حساب. يؤدي استبداله إلى إبطال المفتاح السابق على الفور.

حافظ على أمان مفتاحك. لا تعرضه في كود العميل. تتحقق نقطة النهاية الخاصة بنا من بيانات الاعتماد قبل معالجة الرموز المميزة.

نقطة النهاية: POST /v1/chat/completions

أرسل تلميحك إلى نقطة الدردشة. استخدم model field مضبوطًا إلى uncensored. يضمن ذلك توجيه الطلب إلى النموذج المحدد الخاص بنا.

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

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

قم بتحليل تنسيق أحداث الإرسال الخادم (SSE). تحتوي كل شريحة على نص جزئي. اجمع هذه الشرائح لإعادة بناء الاستجابة الكاملة.

راقب استهلاك الرمز المميز في الشريحة النهائية. يتضمن الحدث الأخير إحصائيات الاستخدام الكاملة. يساعدك ذلك على تتبع التكاليف بدقة.

استدعاء الوظائف واستخدام الأدوات

عرّف الأدوات في جسم الطلب. يعيد النموذج حججاً مهيكلة. قم بتحليل هذه الحجج في منطق تطبيقك.

يدعم تعريفات الأدوات القياسية. استخدم tool_choice لإجبار سلوك محدد. يعمل هذا مع أي SDK متوافق مع OpenAI.

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

وضع JSON والمخرجات المهيكلة

تعيين response_format إلى json_object. يعيد النموذج JSON منظم بدقة. يلغي هذا أخطاء التحليل للبيانات المنظمة.

عرّف مخططك بوضوح. يتبع النموذج تعليماتك بدقة. استخدم هذا لاستخراج البيانات أو توليد التكوين.

التعامل مع أخطاء تحليل JSON. لا تزال الهياكل غير الصالحة تحدث أحياناً. نفذ منطق احتيابي للتطبيقات القوية.

معالجة الأخطاء وحدود المعدل

التعامل مع رموز الحالة HTTP بشكل مناسب. A 401 خطأ يعني أن مفتاحك غير صالح. A 402 خطأ يشير إلى عدم كفاية الرصيد. A 429 خطأ يشير إلى تحديد المعدل.

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

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

cURL

Copycurl https://api.alternativeapiopenai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the primary functions in this module"}]
  }'

Python

Copyfrom openai import OpenAI

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