دليل الدمج للمطورين

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

ابدأ بإنشاء مفتاح API الخاص بك على لوحة التحكم. عنوان URL الأساسي هو HTTPS://api.apiaicheap.com/v1. أرسل مفتاحك في رأس المصادقة كرمز حامل.

• انقر على "الحصول على مفتاح API" وقم بتسجيل الدخول باستخدام Google أو البريد الإلكتروني.
• انسخ المفتاح مباشرة؛ يُعرض مرة واحدة فقط.

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

مثال للرأس

المصادقة: Bearer YOUR_API_KEY

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

أرسل إكمال دردشة أساسي لاختبار إعدادك. استخدم نقطة النهاية POST /v1/chat/completions مع النموذج "uncensored".

هذا يؤكد رصيدك من الرصيد وزمن الاستجابة.

• عيّن الدور إلى "user".
• حافظ على بساطة الرسالة للاختبار الأول.

تحقق من الاستجابة للحصول على حقل النص المولد.

• ابحث عن قيمة "المحتوى" (content).

إذا حصلت على رسالة 200 OK، فإن تكاملك يعمل بشكل صحيح.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

تكامل مكتبة Python

استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI للتكامل بسهولة. وجهها إلى عنوان URL الأساسي الخاص بنا واضبط مفتاح واجهة برمجة التطبيقات الخاص بك.

تتعامل هذه النهج مع عمليات إعادة المحاولة وتحليل JSON تلقائياً.

• ثبّت المكتبة عبر pip.
• اضبط معلمة base_url إلى نقطة النهاية الخاصة بنا.

استدعاء طريقة chat.completions.create.

مرر قائمة رسائلك كوسيط.

• تضمين اسم النموذج "uncensored".

الوصول إلى نص الاستجابة عبر سمات الكائن.

هذه الطريقة نظيفة وقابلة للقراءة لبرامج الإنتاج.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apiaicheap.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 Node.js

تعمل حزمة Node.js SDK بشكل مشابه لنسخة Python. قم بتهيئة العميل باستخدام المفتاح وعنوان URL الأساسي الخاص بنا.

يُتيح لك ذلك استخدام أنماط async/await المألوفة.

• استيراد حزمة OpenAI.
• قم بتكوين عنوان URL الأساسي في المنشئ.

أنشئ طلب إكمال مع رسائلك.

التعامل مع الوعد للحصول على النتيجة.

• استخراج محتوى الرسالة من الاستجابة.

سجّل المخرج للتحقق من استجابة النموذج بشكل صحيح.

هذا الإعداد مثالي لخوادم الويب والخدمات الخلفية.

Copyimport OpenAI from "openai";

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

استجابات التدفق عبر أحداث الإرسال عبر الخادم (SSE)

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

هذا يقلل من زمن الاستجابة المُدرَك للمستخدمين في تطبيقات الدردشة.

• عيّن stream: true في الحمولة (payload).
• معالجة كل قطعة فور وصولها.

ادمج القطع لتشكيل الاستجابة النهائية.

تظهر تفاصيل استهلاك الرموز في الشريحة الأخيرة.

• تحقق من حقل "usage" في الجزء الأخير.

يُبقي هذا النهج واجهة المستخدم متجاوبة أثناء التوليدات الطويلة.

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)

حدود، أخطاء، ونافذة السياق

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

تُعالج الأخطاء برموز حالة HTTP القياسية.

• تشير 401 إلى مفتاح API غير صالح أو مفقود.
• 402 تعني استنفاد رصيدك المدفوع مسبقاً.
• تشير 429 إلى تجاوزك لحد المعدل.

الرفض لا يكلف رصيد. الأخطاء مجانية أيضاً.

الحد الأقصى للإخراج هو 16,000 رمز مميز لكل طلب. اضبط max_tokens إذا كنت تحتاج إلى أقل.

يضمن هذا الهيكل فواتير وأداء قابلين للتنبؤ.