📚 آموزش
اتصال ابزارها به API سازگار با OpenAI: از کلید تا اولین پاسخ
تیم هوشواره
· ⭐ فعال
· ⭐ 50
· ۱۴۰۵/۰۳/۳۰ ۱۷:۱۶
اگر ابزار یا کدی دارید که با API استاندارد OpenAI کار میکند — کتابخانهی رسمی، افزونهها، اکثر ابزارهای متنباز — میتوانید همان را بدون تغییر منطق به هوشواره وصل کنید. فقط دو چیز عوض میشود: آدرس پایه (base URL) و کلید.
مراحل:
۱) از بخش API پنل، یک کلید بسازید. توصیهی جدی: برای هر ابزار یک کلید جداگانه بسازید تا مصرف هر کدام را جدا ببینید و اگر کلیدی لو رفت، فقط همان را باطل کنید. میتوانید کلید را به مدل مشخصی محدود کنید یا برایش سقف مصرف بگذارید.
۲) در تنظیمات ابزارتان، base URL را به آدرس /v1 سرویس تغییر بدهید و کلید را جای api key بگذارید. مثلاً در پایتون با کتابخانهی رسمی:
client = OpenAI(base_url="https://<آدرس سرویس>/v1", api_key="کلید شما")
۳) فهرست مدلهای در دسترس را از /v1/models بگیرید و شناسهی دقیق مدل را در درخواستها استفاده کنید — شناسهها را حدس نزنید.
نکتهی مهم مصرف: پاسخ هر درخواست، اطلاعات مصرف توکن را برمیگرداند؛ اگر ابزارتان لاگ میگیرد، همین را ذخیره کنید تا بعداً گزارش دقیق داشته باشید. برای کارهای خودکارِ پرتکرار (مثلاً دستهبندی متن)، مدل سبک انتخاب کنید — در حجم بالا تفاوت هزینه چشمگیر است.
💬 0 دیدگاه