کلاینتهای سازگار با OpenAI
کلاینتهای دسکتاپی مانند Cherry Studio را میتوان در صورتی که نسخه فعلیشان Base URL و Key سفارشی را میپذیرد بهعنوان OpenAI-compatible provider عمومی تنظیم کرد. این مسیر سازگاری دستی است، نه گواهی فروشنده: از /v1 استفاده کنید، فقط شناسههای نمایان را همگام یا اضافه کنید و ابتدا یک گفتوگوی کوتاه را آزمایش کنید.
پیش از شروع
فقط نسخه فعلی کلاینت را از ناشر رسمی آن نصب کنید. پیش از تغییر پیکربندی محلی در کنسول یک 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 مرجع است؛ پیکربندی قبلی، مقاله یا انتخابگر کلاینت دسترسی را تضمین نمیکند.
پیکربندی
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)تأیید
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 را فورا لغو و جایگزین کنید.