رفع اشکال اتصال به بنفش
پنج تا خطایی که بیشتر از همه موقع وصل‌کردن یه ابزار به بنفش می‌بینی — یعنی چی و چطور درستش کنی.
اگه یه ابزار یا کد رو به بنفش وصل کردی و جواب نمی‌گیره، این مقاله برای توئه — پنج تا خطایی که بیشتر از همه پیش میاد رو با علتش و راه‌حلش می‌بینی. هر بخش رو جدا بخون؛ لازم نیست کل مقاله رو بخونی، فقط بخشی که به مشکلت می‌خوره.
آدرس سرویس اشتباهه
اگه base URL رو دستی تایپ کردی یا از یه جای قدیمی کپی کردی، درخواست اصلاً به بنفش نمی‌رسه —
connection refused یا timeout می‌گیری، نه یه پیام خطا از بنفش (چون سرور مقصد اصلاً بنفش نیست).
راه‌حل: آدرس رو دوباره از صفحه‌ی «اتصال به ابزارها» کپی کن — هیچ‌وقت دستی تایپش نکن یا از یه فایل قدیمی برنداری. این آدرس بین محیط‌ها فرق می‌کنه، پس یه نسخه‌ی ذخیره‌شده از قبل می‌تونه دیگه معتبر نباشه.
خطای احراز هویت (کلید رد شده)
اگه کلیدت اشتباه، ابطال‌شده، یا رونویسی‌شده باشه (مثلاً یه فاصله یا خط جدید اضافه موقع کپی)، سرور درخواست رو با وضعیت HTTP 401 (Unauthorized) رد می‌کنه.
راه‌حل:
- کلید رو دوباره از صفحه‌ی «اتصال به ابزارها» کپی کن — فقط همون رشته، بدون فاصله‌ی اضافه‌ی اول یا آخرش.
- اگه کلید رو قبلاً ابطال کرده باشی، دیگه هیچ‌وقت کار نمی‌کنه — باید یکی جدید بسازی. جزئیاتش تو «هایجین کلید API».
- اگه مطمئنی کلید درسته ولی بازم 401 می‌گیری، احتمالاً ابزارت داره کلید رو یه‌جای دیگه (نه هدر
Authorization) می‌فرسته — تنظیماتش رو با نمونه‌ی curl توapi-quickstartمقایسه کن.
مدلی که خواستی تو منو نیست
اگه یه شناسه‌ی مدل مشخص بدی که ادمین بنفش فعالش نکرده، درخواست رد می‌شه. لیست مدل‌های فعال زنده‌ست و عوض می‌شه — یه شناسه که دیروز کار می‌کرد ممکنه امروز فعال نباشه.
راه‌حل: یه شناسه‌ی واقعی از لیست زنده‌ی مدل‌های فعال بردار — این مسیر مستقیم به gateway می‌زنه، پس مدل «auto»ی چت مرورگر اینجا شناخته‌شده نیست و همین خطا رو می‌ده، نه یه راه‌حل:
- All Minilm L12
- All Minilm L6
- All Mpnet Base
- Bge Base En V1.5
- Bge En Icl
- Bge Large En V1.5
- Bge M3
- Bge M3 Multi
- Claude Haiku 4 5 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Haiku 4 5 20251001 — حدود ۱٬۱۸۳ تومان برای هر پیام معمولی
- Claude Opus 4 6 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Opus 4 7 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Opus 4 8 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Opus 5 — حدود ۵٬۹۱۵ تومان برای هر پیام معمولی
- Claude Opus 5 5 — حدود ۴٬۷۳۲ تومان برای هر پیام معمولی
- Claude Sonnet 4 6 — حدود ۳٬۵۴۹ تومان برای هر پیام معمولی
- Claude Sonnet 5 — حدود ۲٬۳۶۶ تومان برای هر پیام معمولی
- Claude Sonnet 5 5 — حدود ۲٬۳۶۶ تومان برای هر پیام معمولی
- Clip Vit B 32
- Deepseek V4 Flash — حدود ۶۷ تومان برای هر پیام معمولی
- E5 Base
- E5 Large
- Embed Multilingual V3
- Gemini 2.5 Flash — حدود ۵۰۳ تومان برای هر پیام معمولی
- Gemini 2.5 Pro — حدود ۲٬۰۳۵ تومان برای هر پیام معمولی
- Gemini 3.1 Flash Lite — حدود ۳۳۵ تومان برای هر پیام معمولی
- Gemini 3.1 Pro — حدود ۲٬۶۶۲ تومان برای هر پیام معمولی
- Gemini 3.5 Flash — حدود ۱٬۹۹۶ تومان برای هر پیام معمولی
- Gemma 3 12B — حدود ۴۷ تومان برای هر پیام معمولی
- Gemma 3 12B It — حدود ۸۳ تومان برای هر پیام معمولی
- Gemma 3 27B — حدود ۶۱ تومان برای هر پیام معمولی
- Gemma 4 26B A4b — حدود ۸۲ تومان برای هر پیام معمولی
- Gemma 4 31B — حدود ۱۱۳ تومان برای هر پیام معمولی
- Gemma 4 31B Turbo — حدود ۹۰ تومان برای هر پیام معمولی
- Glm 4 7 — حدود ۵۹۱ تومان برای هر پیام معمولی
- Glm 4 7 Flash — حدود ۹۱ تومان برای هر پیام معمولی
- Glm 4.6 — حدود ۵۱۸ تومان برای هر پیام معمولی
- Glm 4.7 — حدود ۴۳۷ تومان برای هر پیام معمولی
- Glm 5 — حدود ۹۱۷ تومان برای هر پیام معمولی
- GPT Oss 120B — حدود ۴۲ تومان برای هر پیام معمولی
- GPT Oss 120B 1 0 — حدود ۱۵۷ تومان برای هر پیام معمولی
- GPT Oss 120B Turbo — حدود ۱۵۷ تومان برای هر پیام معمولی
- GPT Oss 120B Ultra — حدود ۲۳۰ تومان برای هر پیام معمولی
- Gte Base
- Gte Large
- Hermes 3 Llama 3.1 405B — حدود ۵۹۱ تومان برای هر پیام معمولی
- Hermes 3 Llama 3.1 70B — حدود ۴۱۴ تومان برای هر پیام معمولی
- Hy3 — حدود ۱۳۴ تومان برای هر پیام معمولی
- Inkling — حدود ۱٬۰۲۳ تومان برای هر پیام معمولی
- Kimi K2 5 — حدود ۸۵۱ تومان برای هر پیام معمولی
- Kimi K2 Thinking — حدود ۶۳۶ تومان برای هر پیام معمولی
- Kimi K2.6 — حدود ۸۵۲ تومان برای هر پیام معمولی
- Kimi K3 — حدود ۳٬۳۷۴ تومان برای هر پیام معمولی
- L3.1 70B Euryale V2.2 — حدود ۵۰۵ تومان برای هر پیام معمولی
- Ling 3.0 Flash — حدود ۵۵ تومان برای هر پیام معمولی
- Llama 3.1 70B Turbo — حدود ۲۳۷ تومان برای هر پیام معمولی
- Llama 3.3 70B Turbo — حدود ۹۱ تومان برای هر پیام معمولی
- Llama 4 Scout 17B 16E — حدود ۸۹ تومان برای هر پیام معمولی
- Llama Nemotron Embed Vl 1B
- Llama3 70B Instruct — حدود ۲٬۰۳۲ تومان برای هر پیام معمولی
- Mistral Small 3.2 24B Instruct — حدود ۶۶ تومان برای هر پیام معمولی
- Multi Qa Mpnet Base Dot
- Multilingual E5 Large
- Muse Glimmer 30B — حدود ۳۱۱ تومان برای هر پیام معمولی
- Mythomax L2 13B — حدود ۲۳۷ تومان برای هر پیام معمولی
- Nemotron 3 Nano 30B A3b — حدود ۵۴ تومان برای هر پیام معمولی
- Nvidia Nemotron 3 Super 120B A12b — حدود ۱۰۰ تومان برای هر پیام معمولی
- Nvidia Nemotron 3.5 Lightning — حدود ۵۲ تومان برای هر پیام معمولی
- Paraphrase Minilm L6
- Phi 4 — حدود ۵۲ تومان برای هر پیام معمولی
- Qwen2.5 72B — حدود ۲۲۰ تومان برای هر پیام معمولی
- Qwen3 14B — حدود ۸۸ تومان برای هر پیام معمولی
- Qwen3 235B A22b Instruct — حدود ۱۲۲ تومان برای هر پیام معمولی
- Qwen3 30B A3b — حدود ۱۲۶ تومان برای هر پیام معمولی
- Qwen3 32B — حدود ۱۵۷ تومان برای هر پیام معمولی
- Qwen3 Embedding 0.6B
- Qwen3 Embedding 4B
- Qwen3 Embedding 8B
- Qwen3 Max — حدود ۱٬۴۱۹ تومان برای هر پیام معمولی
- Qwen3 Vl 30B A3b — حدود ۱۵۷ تومان برای هر پیام معمولی
- Qwen3.5 27B — حدود ۵۰۲ تومان برای هر پیام معمولی
- Qwen3.5 35B A3b — حدود ۲۰۸ تومان برای هر پیام معمولی
- Qwen3.5 397B A17b — حدود ۶۴۵ تومان برای هر پیام معمولی
- Qwen3.5 9B — حدود ۶۷ تومان برای هر پیام معمولی
- Qwen3.6 27B — حدود ۶۱۴ تومان برای هر پیام معمولی
- Qwen3.6 35B A3b — حدود ۱۸۶ تومان برای هر پیام معمولی
- Qwen3.7 Max — حدود ۲٬۲۱۸ تومان برای هر پیام معمولی
- Qwen3.8 2.4T A95b — حدود ۱٬۷۷۴ تومان برای هر پیام معمولی
- Qwen3.8 Max — حدود ۱٬۴۶۷ تومان برای هر پیام معمولی
- Seed 1.8 — حدود ۴۰۹ تومان برای هر پیام معمولی
- Seed 2.0 Code — حدود ۶۶۵ تومان برای هر پیام معمولی
- Seed 2.0 Mini — حدود ۱۰۴ تومان برای هر پیام معمولی
- Seed 2.0 Pro — حدود ۶۶۵ تومان برای هر پیام معمولی
- Text2vec Base Chinese
- Titan Embed Text V2
کیف پول خالیه
مسیر API هم به موجودی کیف پولت گیت شده. وقتی موجودی ته بکشه، همون کلید هر درخواستی که بفرستی با وضعیت HTTP 402 رد می‌شه — تا وقتی شارژ کنی.
راه‌حل: فقط کیف پولت رو تو «صورت‌حساب» شارژ کن. کلید عوض نمی‌شه، کلید جدیدی هم صادر نمی‌شه — همین کلیدی که همین الان داری، بلافاصله بعد از شارژ دوباره کار می‌کنه. چیزی رو کپی یا جایگزین نکن.
سقف این اجرا پر شده
اگه موقع ساختن کلید یه «سقف هر اجرا» (run cap) براش تعیین کرده باشی، همین که یه اجرا (یه سشن agent) به اون سقف برسه، کلید به‌طور خودکار جایگزین می‌شه — درست مثل کیف پول خالی، فرقش اینه که این یکی انتخابیه (خودت سقفش رو تعیین کردی) و فقط همون کلید رو می‌بنده، نه کل حسابت رو. علامتش: با کلید قدیمی HTTP 401 می‌گیری، بدون این‌که کیف پولت خالی شده باشه.
راه‌حل: برو «اتصال به ابزارها»، کلید جدید رو کپی کن. اگه سقف براش کوتاهه، از همون‌جا می‌تونی زیادش کنی یا کلاً بردارش.
چک‌لیست سریع
قبل از این‌که دنبال کمک بگردی:
- آدرس و کلید رو تازه از صفحه‌ی «اتصال به ابزارها» کپی کن (نه از یه نسخه‌ی قدیمی).
- همون درخواست رو با curl (نمونه‌ی
api-quickstart) امتحان کن — اگه اونم خطا داد، مشکل مطمئناً از تنظیمات سمت بنفشه، نه ابزارت. - مطمئن شو شناسه‌ی مدلی که فرستادی هنوز تو
<ModelList />هست — نه «auto» (که فقط تو چت مرورگر کار می‌کنه، نه رو این مسیر). - یه 401 غیرمنتظره؟ اول چک کن کلیدت به‌طور خودکار جایگزین نشده باشه — سراغ «اتصال به ابزارها» برو.
سوال‌های پرتکرار
- چرا با curl جواب میگیرم ولی تو IDEام نه؟
- معمولاً یعنی IDE هنوز آدرس یا کلید قدیمی رو کش کرده. بعد از هر تجدید کلید یا تغییر تنظیمات، ابزار رو کامل ریاستارت کن.
- چطور مطمئن شم مشکل از بنفشه نه از خود ابزارم؟
- همون درخواست رو با curl (از api-quickstart) بزن. اگه curl هم همون خطا رو داد، مشکل از تنظیمات سمت بنفشه؛ اگه curl جواب داد، مشکل تو تنظیمات ابزارته.