رفع اشکال اتصال به بنفش

اگه یه ابزار یا کد رو به بنفش وصل کردی و جواب نمی‌گیره، این مقاله برای توئه — پنج تا خطایی که بیشتر از همه پیش میاد رو با علتش و راه‌حلش می‌بینی. هر بخش رو جدا بخون؛ لازم نیست کل مقاله رو بخونی، فقط بخشی که به مشکلت می‌خوره.

آدرس سرویس اشتباهه

اگه base URL رو دستی تایپ کردی یا از یه جای قدیمی کپی کردی، درخواست اصلاً به بنفش نمی‌رسه — connection refused یا timeout می‌گیری، نه یه پیام خطا از بنفش (چون سرور مقصد اصلاً بنفش نیست).

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

خطای احراز هویت (کلید رد شده)

اگه کلیدت اشتباه، ابطال‌شده، یا رونویسی‌شده باشه (مثلاً یه فاصله یا خط جدید اضافه موقع کپی)، سرور درخواست رو با وضعیت HTTP 401 (Unauthorized) رد می‌کنه.

راه‌حل:

1. ۱.کلید رو دوباره از صفحه‌ی «اتصال به ابزارها» کپی کن — فقط همون رشته، بدون فاصله‌ی اضافه‌ی اول یا آخرش.
2. ۲.اگه کلید رو قبلاً ابطال کرده باشی، دیگه هیچ‌وقت کار نمی‌کنه — باید یکی جدید بسازی. جزئیاتش تو «هایجین کلید API».
3. ۳.اگه مطمئنی کلید درسته ولی بازم 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 — included with a subscription — no pay-as-you-go price
• Claude Haiku 4 5 20251001 — about ۱٬۱۸۳ تومان per typical message
• Claude Opus 4 6 — included with a subscription — no pay-as-you-go price
• Claude Opus 4 7 — included with a subscription — no pay-as-you-go price
• Claude Opus 4 8 — included with a subscription — no pay-as-you-go price
• Claude Opus 5 — about ۵٬۹۱۵ تومان per typical message
• Claude Opus 5 5 — about ۴٬۷۳۲ تومان per typical message
• Claude Sonnet 4 6 — about ۳٬۵۴۹ تومان per typical message
• Claude Sonnet 5 — about ۲٬۳۶۶ تومان per typical message
• Claude Sonnet 5 5 — about ۲٬۳۶۶ تومان per typical message
• Clip Vit B 32
• Deepseek V4 Flash — about ۶۷ تومان per typical message
• E5 Base
• E5 Large
• Embed Multilingual V3
• Gemini 2.5 Flash — about ۵۰۳ تومان per typical message
• Gemini 2.5 Pro — about ۲٬۰۳۵ تومان per typical message
• Gemini 3.1 Flash Lite — about ۳۳۵ تومان per typical message
• Gemini 3.1 Pro — about ۲٬۶۶۲ تومان per typical message
• Gemini 3.5 Flash — about ۱٬۹۹۶ تومان per typical message
• Gemma 3 12B — about ۴۷ تومان per typical message
• Gemma 3 12B It — about ۸۳ تومان per typical message
• Gemma 3 27B — about ۶۱ تومان per typical message
• Gemma 4 26B A4b — about ۸۲ تومان per typical message
• Gemma 4 31B — about ۱۱۳ تومان per typical message
• Gemma 4 31B Turbo — about ۹۰ تومان per typical message
• Glm 4 7 — about ۵۹۱ تومان per typical message
• Glm 4 7 Flash — about ۹۱ تومان per typical message
• Glm 4.6 — about ۵۱۸ تومان per typical message
• Glm 4.7 — about ۴۳۷ تومان per typical message
• Glm 5 — about ۹۱۷ تومان per typical message
• GPT Oss 120B — about ۴۲ تومان per typical message
• GPT Oss 120B 1 0 — about ۱۵۷ تومان per typical message
• GPT Oss 120B Turbo — about ۱۵۷ تومان per typical message
• GPT Oss 120B Ultra — about ۲۳۰ تومان per typical message
• Gte Base
• Gte Large
• Hermes 3 Llama 3.1 405B — about ۵۹۱ تومان per typical message
• Hermes 3 Llama 3.1 70B — about ۴۱۴ تومان per typical message
• Hy3 — about ۱۳۴ تومان per typical message
• Inkling — about ۱٬۰۲۳ تومان per typical message
• Kimi K2 5 — about ۸۵۱ تومان per typical message
• Kimi K2 Thinking — about ۶۳۶ تومان per typical message
• Kimi K2.6 — about ۸۵۲ تومان per typical message
• Kimi K3 — about ۳٬۳۷۴ تومان per typical message
• L3.1 70B Euryale V2.2 — about ۵۰۵ تومان per typical message
• Ling 3.0 Flash — about ۵۵ تومان per typical message
• Llama 3.1 70B Turbo — about ۲۳۷ تومان per typical message
• Llama 3.3 70B Turbo — about ۹۱ تومان per typical message
• Llama 4 Scout 17B 16E — about ۸۹ تومان per typical message
• Llama Nemotron Embed Vl 1B
• Llama3 70B Instruct — about ۲٬۰۳۲ تومان per typical message
• Mistral Small 3.2 24B Instruct — about ۶۶ تومان per typical message
• Multi Qa Mpnet Base Dot
• Multilingual E5 Large
• Muse Glimmer 30B — about ۳۱۱ تومان per typical message
• Mythomax L2 13B — about ۲۳۷ تومان per typical message
• Nemotron 3 Nano 30B A3b — about ۵۴ تومان per typical message
• Nvidia Nemotron 3 Super 120B A12b — about ۱۰۰ تومان per typical message
• Nvidia Nemotron 3.5 Lightning — about ۵۲ تومان per typical message
• Paraphrase Minilm L6
• Phi 4 — about ۵۲ تومان per typical message
• Qwen2.5 72B — about ۲۲۰ تومان per typical message
• Qwen3 14B — about ۸۸ تومان per typical message
• Qwen3 235B A22b Instruct — about ۱۲۲ تومان per typical message
• Qwen3 30B A3b — about ۱۲۶ تومان per typical message
• Qwen3 32B — about ۱۵۷ تومان per typical message
• Qwen3 Embedding 0.6B
• Qwen3 Embedding 4B
• Qwen3 Embedding 8B
• Qwen3 Max — about ۱٬۴۱۹ تومان per typical message
• Qwen3 Vl 30B A3b — about ۱۵۷ تومان per typical message
• Qwen3.5 27B — about ۵۰۲ تومان per typical message
• Qwen3.5 35B A3b — about ۲۰۸ تومان per typical message
• Qwen3.5 397B A17b — about ۶۴۵ تومان per typical message
• Qwen3.5 9B — about ۶۷ تومان per typical message
• Qwen3.6 27B — about ۶۱۴ تومان per typical message
• Qwen3.6 35B A3b — about ۱۸۶ تومان per typical message
• Qwen3.7 Max — about ۲٬۲۱۸ تومان per typical message
• Qwen3.8 2.4T A95b — about ۱٬۷۷۴ تومان per typical message
• Qwen3.8 Max — about ۱٬۴۶۷ تومان per typical message
• Seed 1.8 — about ۴۰۹ تومان per typical message
• Seed 2.0 Code — about ۶۶۵ تومان per typical message
• Seed 2.0 Mini — about ۱۰۴ تومان per typical message
• Seed 2.0 Pro — about ۶۶۵ تومان per typical message
• Text2vec Base Chinese
• Titan Embed Text V2

کیف پول خالیه

مسیر API هم به موجودی کیف پولت گیت شده. وقتی موجودی ته بکشه، همون کلید هر درخواستی که بفرستی با وضعیت HTTP 402 رد می‌شه — تا وقتی شارژ کنی.

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

سقف این اجرا پر شده

اگه موقع ساختن کلید یه «سقف هر اجرا» (run cap) براش تعیین کرده باشی، همین که یه اجرا (یه سشن agent) به اون سقف برسه، کلید به‌طور خودکار جایگزین می‌شه — درست مثل کیف پول خالی، فرقش اینه که این یکی انتخابیه (خودت سقفش رو تعیین کردی) و فقط همون کلید رو می‌بنده، نه کل حسابت رو. علامتش: با کلید قدیمی HTTP 401 می‌گیری، بدون این‌که کیف پولت خالی شده باشه.

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

چک‌لیست سریع

قبل از این‌که دنبال کمک بگردی:

1. ۱.آدرس و کلید رو تازه از صفحه‌ی «اتصال به ابزارها» کپی کن (نه از یه نسخه‌ی قدیمی).
2. ۲.همون درخواست رو با curl (نمونه‌ی api-quickstart) امتحان کن — اگه اونم خطا داد، مشکل مطمئناً از تنظیمات سمت بنفشه، نه ابزارت.
3. ۳.مطمئن شو شناسه‌ی مدلی که فرستادی هنوز تو <ModelList /> هست — نه «auto» (که فقط تو چت مرورگر کار می‌کنه، نه رو این مسیر).
4. ۴.یه 401 غیرمنتظره؟ اول چک کن کلیدت به‌طور خودکار جایگزین نشده باشه — سراغ «اتصال به ابزارها» برو.