شروع سریع با API بنفش

اگه برنامه‌نویسی و می‌خوای بنفش رو تو کد خودت صدا بزنی — نه فقط از توی چت — این مقاله برای توئه. تا آخرش که برسی، یه کلید API داری و اولین درخواستت رو با curl جواب گرفته.

قدم اول: یه کلید بساز

از صفحه‌ی «اتصال به ابزارها» یه کلید جدید بساز. کلید فقط یه بار کامل نشونت داده می‌شه — همون‌جا کپیش کن و یه‌جای امن نگهش دار.

قدم دوم: اولین درخواست

endpoint بنفش با فرمت OpenAI سازگاره، پس اگه قبلاً با اون کار کردی، همه‌چی آشناست. آدرس دقیق سرویس رو از همون صفحه‌ی «اتصال به ابزارها» کپی کن — چون این آدرس محیط به محیط فرق می‌کنه، همیشه از همون‌جا بگیرش، حدس نزن:

curl YOUR_SERVICE_URL/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{ "role": "user", "content": "سلام، خودت رو معرفی کن" }]
  }'

YOUR_MODEL_ID رو با شناسه‌ی یکی از مدل‌های فعال عوض کن — این مسیر مستقیم به gateway می‌زنه، نه به چت خودِ بنفش، برای همین "auto" (که تو چت مرورگر «بهترین رو خودکار انتخاب کن» معنی می‌ده) اینجا شناخته‌شده نیست و رد می‌شه. لیست زنده‌ی مدل‌های فعال رو تو مقاله‌ی بعدی («کدوم مدل رو انتخاب کنم؟») یا رو صفحه‌ی «اتصال به ابزارها» می‌بینی.

قدم سوم: مدل مناسب رو انتخاب کن

مقاله‌ی بعدی («کدوم مدل رو انتخاب کنم؟») توضیح می‌ده کدوم مدل برای چه کاری مناسب‌تره و لیست زنده‌ش رو نشون می‌ده.

نکته‌ی امنیتی مهم

کلید API هیچ‌وقت نباید توی کد سمت مرورگر یا اپ موبایل بمونه. همیشه از یه سرور واسط (backend خودت) درخواست رو بفرست، نه مستقیم از دستگاه کاربر.