توثيق المطور

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

استخدام https://api.caiapi.cc/v1 كعنوان URL الأساسي. قم بالمصادقة عن طريق تمرير مفتاح API الفريد الخاص بك في Authorization الرأس. يسمح هذا النهج القياسي لك باستبدال أي مكتبة SDK متوافقة مع OpenAI دون إعادة كتابة منطق الاتصال.

Copycurl https://api.caiapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Get user_id 99 for account settings."}]
  }'

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

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

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

Copyfrom openai import OpenAI

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

تتوقع استجابة نصية مباشرة. يتجاهل النموذج فلاتر المحتوى القياسية، مما يجعله مثالياً لأدوار التمثيل أو الكتابة الإبداعية.

تكامل Node SDK

ثبّت حزمة SDK الرسمية وقم بتكوينها لتشير إلى نقطة النهاية الخاصة بنا. يضمن ذلك التوافق مع مشاريع TypeScript أو JavaScript الحالية.

Copyimport OpenAI from "openai";

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

التعامل مع كائن الاستجابة لاستخراج النص المُولّد. يتطابق الهيكل مع مخرجات OpenAI القياسية.

استجابات البث

فعّل البث عن طريق تعيين 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)

تظهر تفاصيل استهلاك الرموز في الشريحة الأخيرة. هذه الطريقة مثالية لواجهات الدردشة في الوقت الفعلي.

استدعاء الوظائف ووضع JSON

عرّف الأدوات في طلبك للحصول على إخراج مهيكلي. استخدم response_format: {"type": "json_object"} لإجبار تنسيق JSON الصارم.

تتيح هذه الميزة لتطبيقك تحليل مخرجات النموذج برمجيًا. تعمل بشكل موثوق مع النموذج غير الخاضع للرقابة لكل من المهام الإبداعية والمنطقية.

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

الحد: 300 طلب في الدقيقة. متزامن: 8 طلبات لكل مفتاح. الخطأ 401 يعني مفتاحاً غير صالح. الخطأ 402 يعني عدم وجود رصيد. الخطأ 429 يعني تجاوز حد المعدل. نافذة السياق: 100,000 رمز. الحد الأقصى للمخرجات: 16,000 رمز.

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