رفع اشکال اتصال به بنفش
پنج تا خطایی که بیشتر از همه موقع وصلکردن یه ابزار به بنفش میبینی — یعنی چی و چطور درستش کنی.
اگه یه ابزار یا کد رو به بنفش وصل کردی و جواب نمیگیره، این مقاله برای توئه — پنج تا خطایی که بیشتر از همه پیش میاد رو با علتش و راهحلش میبینی. هر بخش رو جدا بخون؛ لازم نیست کل مقاله رو بخونی، فقط بخشی که به مشکلت میخوره.
آدرس سرویس اشتباهه
اگه base URL رو دستی تایپ کردی یا از یه جای قدیمی کپی کردی، درخواست اصلاً به بنفش نمیرسه —
connection refused یا timeout میگیری، نه یه پیام خطا از بنفش (چون سرور مقصد اصلاً بنفش نیست).
راهحل: آدرس رو دوباره از صفحهی «اتصال به ابزارها» کپی کن — هیچوقت دستی تایپش نکن یا از یه فایل قدیمی برنداری. این آدرس بین محیطها فرق میکنه، پس یه نسخهی ذخیرهشده از قبل میتونه دیگه معتبر نباشه.
خطای احراز هویت (کلید رد شده)
اگه کلیدت اشتباه، ابطالشده، یا رونویسیشده باشه (مثلاً یه فاصله یا خط جدید اضافه موقع کپی)، سرور درخواست رو با وضعیت HTTP 401 (Unauthorized) رد میکنه.
راهحل:
- کلید رو دوباره از صفحهی «اتصال به ابزارها» کپی کن — فقط همون رشته، بدون فاصلهی اضافهی اول یا آخرش.
- اگه کلید رو قبلاً ابطال کرده باشی، دیگه هیچوقت کار نمیکنه — باید یکی جدید بسازی. جزئیاتش تو «هایجین کلید API».
- اگه مطمئنی کلید درسته ولی بازم 401 میگیری، احتمالاً ابزارت داره کلید رو یهجای دیگه (نه هدر
Authorization) میفرسته — تنظیماتش رو با نمونهی curl توapi-quickstartمقایسه کن.
مدلی که خواستی تو منو نیست
اگه یه شناسهی مدل مشخص بدی که ادمین بنفش فعالش نکرده، درخواست رد میشه. لیست مدلهای فعال زندهست و عوض میشه — یه شناسه که دیروز کار میکرد ممکنه امروز فعال نباشه.
راهحل: یه شناسهی واقعی از لیست زندهی مدلهای فعال بردار — این مسیر مستقیم به gateway میزنه، پس مدل «auto»ی چت مرورگر اینجا شناختهشده نیست و همین خطا رو میده، نه یه راهحل:
- 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 Fable 5 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Haiku 4 5 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Opus 4 6 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Opus 4 7 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Opus 4 8 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Opus 5 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Sonnet 4 6 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Claude Sonnet 5 — فقط با اشتراک — بدون قیمت پرداخت مصرفی
- Clip Vit B 32
- Deepseek — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Deepseek V4 Flash — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Deepseek V4 Pro — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- 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 3 4B — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Gemma 4 26B A4b — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Gemma 4 31B — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Gemma 4 31B It Ultra — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Gemma 4 31B Turbo — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Gemma 4 E4b — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- 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 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- GPT Oss 20B — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- 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.5 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Kimi K2.6 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Kimi K2.7 Code — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Kimi K3 — حدود ۶٬۹۱۵ تومان برای هر پیام معمولی
- L3 8B Lunaris Turbo — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- L3.1 70B Euryale V2.2 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Ling 3.0 Flash — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Llama 3.1 70B Turbo — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Llama 3.1 8B Turbo — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Llama 3.3 70B Turbo — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Llama 4 Maverick 17B 128E Fp8 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Llama 4 Scout 17B 16E — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Llama Nemotron Embed Vl 1B
- Llama3 70B Instruct — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Mimo V2.5 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Minimax M2.7 Turbo — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Minimax M3 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Mistral Nemo Instruct — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Mistral Small 24B 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 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Nova Micro — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Nova Pro — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Nvidia Nemotron 3 Super 120B A12b — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Nvidia Nemotron 3 Ultra 550B A55b — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Nvidia Nemotron 3.5 Lightning — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Paraphrase Minilm L6
- Phi 4 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen2.5 72B — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 14B — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 235B A22b Instruct — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 235B A22b Thinking — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 30B A3b — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 32B — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 Coder 480B A35b Turbo — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 Embedding 0.6B
- Qwen3 Embedding 4B
- Qwen3 Max — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 Max Thinking — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3 Vl 30B A3b — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Qwen3.5 122B A10b — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- 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 — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- Step 3.7 Flash — حدود ۴٬۶۱۰ تومان برای هر پیام معمولی
- 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 جواب داد، مشکل تو تنظیمات ابزارته.