لم تتم ترجمة هذا المقال إلى هذه اللغة بعد؛ تشاهد النسخة الفارسية.

متوسط

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

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

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

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

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

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

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

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

راه‌حل:

  1. کلید رو دوباره از صفحه‌ی «اتصال به ابزارها» کپی کن — فقط همون رشته، بدون فاصله‌ی اضافه‌ی اول یا آخرش.
  2. اگه کلید رو قبلاً ابطال کرده باشی، دیگه هیچ‌وقت کار نمی‌کنه — باید یکی جدید بسازی. جزئیاتش تو «هایجین کلید API».
  3. اگه مطمئنی کلید درسته ولی بازم 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 می‌گیری، بدون این‌که کیف پولت خالی شده باشه.

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

چک‌لیست سریع

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

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

الأسئلة الشائعة

چرا با curl جواب می‌گیرم ولی تو IDE‌ام نه؟
معمولاً یعنی IDE هنوز آدرس یا کلید قدیمی رو کش کرده. بعد از هر تجدید کلید یا تغییر تنظیمات، ابزار رو کامل ری‌استارت کن.
چطور مطمئن شم مشکل از بنفشه نه از خود ابزارم؟
همون درخواست رو با curl (از api-quickstart) بزن. اگه curl هم همون خطا رو داد، مشکل از تنظیمات سمت بنفشه؛ اگه curl جواب داد، مشکل تو تنظیمات ابزارته.