عملاء متوافقون مع OpenAI
يمكن إعداد عملاء سطح المكتب مثل Cherry Studio كـ OpenAI-compatible provider عام إذا كان إصدارهم الحالي يدعم Base URL ومفتاحا مخصصين. هذا مسار توافق يدوي وليس اعتمادا خاصا بالمورد: استخدم /v1، وزامن أو أضف المعرّفات الظاهرة فقط، واختبر محادثة قصيرة أولا.
قبل البدء
ثبّت الإصدار الحالي للعميل من ناشره الرسمي فقط. أنشئ API Key مخصصا في لوحة التحكم قبل تعديل الإعداد المحلي، ولا تعِد استخدام مفتاح شخصي أو مشترك أو خاص بنشر الإنتاج.
Windows وmacOS وLinux
- Windows: استخدم مثبت Windows الحالي أو مسار PowerShell وأغلق جميع عمليات العميل بعد تغيير ملف إعداد.
- macOS: استخدم التطبيق الموقّع أو مثبت الطرفية الرسمي المناسب للمعالج؛ الإعدادات في الدليل المنزلي تخص مستخدم macOS هذا.
- Linux / WSL: اتبع التعليمات الحالية للتوزيعة أو CLI الرسمي؛ يقرأ WSL دليله المنزلي في Linux لا ملف تعريف Windows.
اختيار نموذج
استدع GET /v1/models بالمفتاح المخصص واختر data[].id معادا. القائمة المحصورة بالمفتاح هي المرجع؛ الإعداد السابق أو المقال أو منتقي العميل لا يضمن الوصول.
التهيئة
from openai import OpenAI
client = OpenAI(api_key="sk-your-own-key", base_url="https://ai.tavonilo.com/v1")
print(client.chat.completions.create(
model="your-console-model",
messages=[{"role": "user", "content": "Reply with connected."}],
).choices[0].message.content)التحقق
تحقق من المفتاح بواسطة /v1/models وأرسل طلبا صغيرا غير حساس مرة واحدة، واحتفظ للدعم بالوقت والمسار والنموذج وحالة HTTP وrequest ID فقط. لا يثبت timeout أن التوليد القابل للفوترة لم يعالج، لذلك لا تعيد طلبات الصور أو التوليد الطويل عشوائيا.
استعادة آمنة
- 401: استبدل المفتاح الناقص أو الملغى أو الخاطئ، ولا تلصقه في طلب دعم.
- 403: افحص مجموعة المفتاح وظهور النموذج والرصيد وصلاحية المسار.
- 404: استخدم Base URL المعروض هنا لا endpoint كاملا، ولا تضف /v1 مرتين.
- 429: ضع العمل في طابور واتبع Retry-After عند وجوده؛ لا تعِد batch بالتوازي.
- 5xx أو timeout: أعد المحاولة بشكل محدود فقط عندما تكون العملية آمنة. احتفظ بالوقت والمسار والنموذج وحالة HTTP وrequest ID في سجلات منقحة.
حد بيانات الاعتماد
استخدم مفتاحا لكل جهاز أو عبء عمل. لا ترسل أبدا API Key أو auth.json أو موجها خاصا كاملا أو كلمة مرور أو رمز تحقق أو بيانات دفع للدعم؛ ألغ المفتاح واستبدله فورا عند الاشتباه في تسربه.