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

متوسط

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

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

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

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

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

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

اگه به جای اون خطاها HTTP 404 گرفتی، معمولاً شکل آدرس با ابزارت نمی‌خونه. کارت «آدرس سرویس» دو شکل داره: Claude Code و SDKهای Anthropic آدرس رو بدون /v1 می‌خوان (خودشون /v1/messages رو اضافه می‌کنن)؛ ابزارهای سازگار با OpenAI (SDKهای OpenAI، Cursor، Cline، aider و…) با /v1 (خودشون فقط /chat/completions رو اضافه می‌کنن). ردیف درست رو برای ابزارت کپی کن.

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

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

راه‌حل:

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

مدلی که خواستی تو منو نیست

اگه یه شناسه‌ی مدل مشخص بدی که ادمین بنفش فعالش نکرده، درخواست رد می‌شه. لیست مدل‌های فعال زنده‌ست و عوض می‌شه — یه شناسه که دیروز کار می‌کرد ممکنه امروز فعال نباشه.

راه‌حل: یه شناسه‌ی واقعی از لیست زنده‌ی مدل‌های فعال بردار — این مسیر مستقیم به gateway می‌زنه، پس مدل «auto»ی چت مرورگر اینجا شناخته‌شده نیست و همین خطا رو می‌ده، نه یه راه‌حل:

  • Bge M3
  • Claude Haiku 4.5 — مع الاشتراك فقط — بلا سعر للدفع حسب الاستخدام
  • Claude Haiku 4.5 — حوالي ۱٬۲۵۶ تومان لكل رسالة عادية
  • 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 — حوالي ۲٬۵۱۲ تومان لكل رسالة عادية
  • Deepseek V4 Flash — حوالي ۷۱ تومان لكل رسالة عادية
  • Embed Multilingual V3
  • Gemini 3.1 Flash Lite — حوالي ۳۵۶ تومان لكل رسالة عادية
  • Gemini 3.1 Pro — حوالي ۲٬۸۲۶ تومان لكل رسالة عادية
  • Gemini 3.5 Flash — حوالي ۲٬۱۱۹ تومان لكل رسالة عادية
  • Gemma 4 26B A4b — حوالي ۸۷ تومان لكل رسالة عادية
  • Gemma 4 31B — حوالي ۱۲۰ تومان لكل رسالة عادية
  • Glm 4.7 Flash — حوالي ۹۷ تومان لكل رسالة عادية
  • Glm 5 — حوالي ۹۷۳ تومان لكل رسالة عادية
  • GPT Oss 120B — حوالي ۴۴ تومان لكل رسالة عادية
  • GPT-6 Astra — حوالي ۱۲٬۵۵۸ تومان لكل رسالة عادية
  • GPT-6 Luna — حوالي ۱۲۶ تومان لكل رسالة عادية
  • GPT-6.1 Sol — حوالي ۲٬۵۱۲ تومان لكل رسالة عادية
  • Grok 4.7 — حوالي ۱٬۸۸۴ تومان لكل رسالة عادية
  • Kimi K2 Thinking — حوالي ۶۷۵ تومان لكل رسالة عادية
  • Kimi K2.6 — حوالي ۹۰۵ تومان لكل رسالة عادية
  • Llama 3.3 70B Turbo — حوالي ۹۷ تومان لكل رسالة عادية
  • Llama 4 Scout 17B 16E — حوالي ۹۴ تومان لكل رسالة عادية
  • Mistral Large 3 — حوالي ۴۷۱ تومان لكل رسالة عادية
  • Mistral Small 3.2 24B Instruct — حوالي ۷۰ تومان لكل رسالة عادية
  • Multilingual E5 Large
  • Qwen3 235B A22b Instruct — حوالي ۱۳۰ تومان لكل رسالة عادية
  • Qwen3 Coder 480B A35b Turbo — حوالي ۲۹۸ تومان لكل رسالة عادية
  • Qwen3 Embedding 8B
  • Qwen3 Vl 30B A3b — حوالي ۱۶۷ تومان لكل رسالة عادية
  • Qwen3.5 397B A17b — حوالي ۶۸۵ تومان لكل رسالة عادية
  • Qwen3.6 35B A3b — حوالي ۱۹۷ تومان لكل رسالة عادية
  • Qwen3.8 Max — حوالي ۱٬۵۵۷ تومان لكل رسالة عادية
  • Titan Embed Text V2

کیف پول خالیه

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

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

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

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

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

چک‌لیست سریع

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

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

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

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