Cherry Studio
مقادیر پروتکل زیر را دقیقا استفاده کنید، پس از ذخیره کلاینت را راهاندازی مجدد کنید و پیش از فعال کردن کار طولانی، tools یا media یک درخواست خصوصی کوتاه را بررسی کنید.
پیش از شروع
فقط نسخه فعلی کلاینت را از ناشر رسمی آن نصب کنید. پیش از تغییر پیکربندی محلی در کنسول یک API Key اختصاصی بسازید؛ Key شخصی، مشترک یا استقرار تولید را دوباره استفاده نکنید.
Windows، macOS و Linux
- Windows: از نصبکننده فعلی Windows یا روند PowerShell استفاده کنید و پس از تغییر فایل پیکربندی همه فرایندهای کلاینت را ببندید.
- macOS: از برنامه امضاشده یا نصبکننده رسمی ترمینال مناسب CPU استفاده کنید؛ تنظیمات دایرکتوری خانگی متعلق به همان کاربر macOS است.
- Linux / WSL: دستورالعمل فعلی توزیع یا CLI رسمی را دنبال کنید؛ WSL دایرکتوری خانگی Linux را میخواند نه پروفایل Windows را.
انتخاب مدل
با Key اختصاصی GET /v1/models را فراخوانی و یک data[].id برگشتی را انتخاب کنید. فهرست محدودشده به Key مرجع است؛ پیکربندی قبلی، مقاله یا انتخابگر کلاینت دسترسی را تضمین نمیکند.
پیکربندی
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تأیید
Key را با /v1/models بررسی کنید، یک درخواست کوچک بدون داده حساس بفرستید و برای پشتیبانی فقط زمان، مسیر، مدل، وضعیت HTTP و request ID را نگه دارید. timeout ثابت نمیکند تولید قابلهزینه پردازش نشده است، پس درخواست طولانی یا تصویری را کورکورانه تکرار نکنید.
بازیابی ایمن
- 401: Key ناقص، لغوشده یا نادرست را جایگزین کنید و آن را در درخواست پشتیبانی نچسبانید.
- 403: گروه Key، نمایش مدل، موجودی و مجوز route را بررسی کنید.
- 404: Base URL نشاندادهشده را استفاده کنید، نه endpoint کامل؛ /v1 را دوبار اضافه نکنید.
- 429: کار را صفبندی و در صورت وجود Retry-After را رعایت کنید؛ یک batch را همزمان دوباره نفرستید.
- 5xx یا timeout: فقط در صورت امن بودن عملیات با حد مشخص دوباره تلاش کنید. زمان، route، model، وضعیت HTTP و request ID را در لاگ حذفشده از راز نگه دارید.
مرز اعتبارنامه
برای هر دستگاه یا بار کاری Key جدا استفاده کنید. هرگز API Key، auth.json، متن کامل خصوصی، گذرواژه، کد تأیید یا اطلاعات پرداخت را برای پشتیبانی نفرستید؛ با احتمال افشا Key را فورا لغو و جایگزین کنید.