کلید API مثل رمز عبور برنامه‌ی شماست. هر درخواست را با هدر Authorization: Bearer YOUR_API_KEY امضا می‌کنید و سرویس بر اساس آن می‌فهمد درخواست از کیست و هزینه از کدام حساب کم شود.
اصل اول: کلید را فاش نکنید. آن را در فرانت‌اند، مخزن عمومی گیت یا اسکرین‌شات نگذارید. از متغیر محیطی استفاده کنید، برای هر پروژه یا محیط کلید جدا بسازید و در صورت نشت فوراً آن را غیرفعال کنید.
اصل دوم: دسترسی را محدود کنید. سقف ماهانه و محدودیت نرخ برای هر کلید، اثر نشت یا خطای برنامه (مثل حلقه‌ی بی‌پایان) را کم می‌کند. کلیدها به‌صورت دوره‌ای باید چرخانده شوند.
PICOAI_API_KEY=YOUR_API_KEYمثال کاربردی
فرض کنید یک پیمانکار برای ساخت نمونه‌ی اولیه به کلید نیاز دارد. بهتر است کلید جداگانه با سقف ماهانه‌ی کم بسازید و پس از پایان کار آن را غیرفعال کنید، نه اینکه کلید اصلی تولید را به اشتراک بگذارید.
چطور در عمل بررسی کنیم؟
بهترین راه یادگرفتن این مفهوم، دیدن آن در یک درخواست واقعی است. یک کلید بسازید، فهرست مدل‌ها را با /v1/models بگیرید، یک درخواست کوچک بفرستید و فیلدهای پاسخ (از جمله usage و finish_reason) را بخوانید. سپس همان درخواست را با پارامتر یا مدل دیگر تکرار و در داشبورد مصرف و هزینه را مقایسه کنید. نمونه‌های آماده در راهنمای cURL و راهنمای پایتون هست.
اصطلاحات نزدیک
- محدودیت نرخ: محدودیت نرخ سقف تعداد درخواست یا توکن در بازه‌ی زمانی مشخص است که برای حفظ پایداری و جلوگیری از سوءاستفاده اعمال میشود.
- آدرس پایه (Base URL): Base URL آدرس ریشه‌ی یک API است که مسیرهای مختلف مثل /chat/completions به آن اضافه میشود؛ با تغییر آن می‌توان همان کلاینت را به سرویس دیگری وصل کرد.
- API سازگار با OpenAI: API سازگار با OpenAI سرویسی است که همان مسیرها، قالب درخواست و پاسخ API رسمی OpenAI را پیاده کرده تا کلاینت‌ها و ابزارهای موجود بدون تغییر با آن کار کنند.
- جایگزینی خودکار مسیر: Failover یعنی وقتی مسیر یا ارائه‌دهنده‌ی اصلی خطا می‌دهد یا کند است، درخواست به‌طور خودکار به مسیر پشتیبان فرستاده شود.
در پیکو هوش
در داشبورد کلید میسازید؛ کلید فقط یکبار کامل نمایش داده میشود، میتوانید برایش سقف ماهانه تعیین یا آن را غیرفعال کنید.
اشتباهات رایج
- قرار دادن کلید در کد جاوااسکریپت مرورگر.
- استفاده از یک کلید برای همه‌ی پروژه‌ها.
پرسش‌های متداول
کلیدم لو رفت، چه کنم؟
فوراً آن را در داشبورد غیرفعال و کلید جدید بسازید و مصرف اخیر را بررسی کنید.
آیا کلید انقضا دارد؟
انقضای خودکار ندارد؛ شما میتوانید هر زمان غیرفعالش کنید.
کلید API در پیکو هوش چه نقشی دارد؟
در داشبورد کلید میسازید؛ کلید فقط یکبار کامل نمایش داده میشود، میتوانید برایش سقف ماهانه تعیین یا آن را غیرفعال کنید.
از تعریف تا عمل
ثبت‌نام کنید، یک کلید بسازید و مفهوم را روی مدل واقعی امتحان کنید.