Cherry Studio
استخدم قيم البروتوكول التالية كما هي، وأعد تشغيل العميل بعد الحفظ، ثم تحقق من طلب خاص قصير قبل تفعيل العمل الطويل أو tools أو media.
قبل البدء
ثبّت الإصدار الحالي للعميل من ناشره الرسمي فقط. أنشئ API Key مخصصا في لوحة التحكم قبل تعديل الإعداد المحلي، ولا تعِد استخدام مفتاح شخصي أو مشترك أو خاص بنشر الإنتاج.
Windows وmacOS وLinux
- Windows: استخدم مثبت Windows الحالي أو مسار PowerShell وأغلق جميع عمليات العميل بعد تغيير ملف إعداد.
- macOS: استخدم التطبيق الموقّع أو مثبت الطرفية الرسمي المناسب للمعالج؛ الإعدادات في الدليل المنزلي تخص مستخدم macOS هذا.
- Linux / WSL: اتبع التعليمات الحالية للتوزيعة أو CLI الرسمي؛ يقرأ WSL دليله المنزلي في Linux لا ملف تعريف Windows.
اختيار نموذج
استدع GET /v1/models بالمفتاح المخصص واختر data[].id معادا. القائمة المحصورة بالمفتاح هي المرجع؛ الإعداد السابق أو المقال أو منتقي العميل لا يضمن الوصول.
التهيئة
Provider protocol: OpenAI-compatible
Base URL: https://ai.tavonilo.com/v1
API key: sk-your-own-key
Model ID: copy one id from GET /v1/modelsالتحقق
تحقق من المفتاح بواسطة /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 أو موجها خاصا كاملا أو كلمة مرور أو رمز تحقق أو بيانات دفع للدعم؛ ألغ المفتاح واستبدله فورا عند الاشتباه في تسربه.