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

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

نقطة نهاية واجهة برمجة التطبيقات (API) هي HTTPS://api.aichatuncensored.cc/v1. قم بالمصادقة على كل طلب عن طريق تمرير مفتاح API الفريد الخاص بك في Authorization: Bearer <key> الرأس. تتلقى هذا المفتاح فورًا بعد التسجيل عبر Google أو البريد الإلكتروني في صفحة احصل على مفتاح API. لا يلزم رقم هاتف، ويظهر المفتاح مرة واحدة فقط للأمان.

Copycurl https://api.aichatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current UTC timestamp"}]
  }'

يعمل عنوان URL الأساسي هذا مع واجهات برمجة التطبيقات الرسمية لـ OpenAI وأي عميل متوافق. قم ببساطة بتكوين مكتبتك للإشارة إلى عنواننا. يمكنك إنشاء مفتاح جديد في أي وقت، والذي يحل محل المفتاح السابق. كل حساب محدود بمفتاح نشط واحد.

الطلب الأول باستخدام cURL

أرسل أول موجه باستخدام معيار POST طلب إلى /v1/chat/completions. معرف النموذج هو uncensored, والذي يخدم نموذجاً مفتوح الوزن واحداً مضبوطاً للمحتوى غير المقيد. يدخل النص إلى messages مصفوفة. تعيد الاستجابة النص المُولّد في content الحقل.

Copycurl https://api.aichatuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current UTC timestamp"}]
  }'

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

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

استخدم مكتبة Python الرسمية للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا. اضبط عنوان URL الأساسي ومفتاح API في تكوين العميل. يتيح لك ذلك الاستفادة من الطرق المألوفة مثل chat.completions.create. تعكس البنية تطبيقات OpenAI القياسية.

Copyfrom openai import OpenAI

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

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

إعداد SDK Node.js

قم تهيئة عميل Node.js بعنوان URL الأساسي والمفتاح. هذا يمكّنك من إجراء مكالمات مباشرة إلى نقطة نهاية إكمال المحادثة. تتولى المكتبة عملية تسلسل JSON وإحقاق الرؤوس تلقائيًا.

Copyimport OpenAI from "openai";

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

استدعاء طريقة الإكمال مع رسائل النص المطلوب. تتضمن الاستجابة النص المُولّد وعدد الرموز. يمكنك تدفق النتائج عن طريق تعيين علم التدفق إلى true. معالجة الأخطاء مدمجة في مكتلة SDK. تحقق من رمز الحالة لاستجابات 401 أو 429 لإدارة الحدود.

استجابات البث (SSE)

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

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)

قم بتحليل تدفق SSE لتجميع الاستجابة النهائية. يتضمن الشريحة الأخيرة إجمالي استخدام الرموز المميزة. يمكنك إيقاف التدفق مبكرًا إذا لزم الأمر. تدعم استدعاءات الوظائف ووضع JSON أيضًا التدفق. هذه الميزة مثالية لواجهات الدردشة في الوقت الفعلي.

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

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

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