Qwen Code با یوتاپن — modelProviders در settings.json

Qwen Code یک ایجنت کدنویسی ترمینالی است که provider نوع openai آن به‌صورت پیش‌فرض با Chat Completions کار می‌کند — دقیقاً همان چیزی که یوتاپن سرو می‌کند. این صفحه با مستندات رسمی مخزن در شهریور ۱۴۰۵ بررسی شده است.

راه سریع

export OPENAI_BASE_URL="https://api.uttapen.ir/v1"
export OPENAI_API_KEY="sk-up-..."
export OPENAI_MODEL="anthropic/claude-sonnet-5"
qwen

برای کار پایدارتر (چند مدل، سقف توکن، انتخاب با دستور /model) بلوک modelProviders را در ~/.qwen/settings.json بنویس.

settings.json

{
  "modelProviders": {
    "openai": [
      {
        "id": "anthropic/claude-sonnet-5",
        "name": "Claude Sonnet 5",
        "envKey": "UTTAPEN_API_KEY",
        "baseUrl": "https://api.uttapen.ir/v1",
        "generationConfig": {
          "contextWindowSize": 200000,
          "samplingParams": { "max_tokens": 8192 }
        }
      },
      {
        "id": "qwen/qwen3-coder",
        "name": "Qwen3 Coder",
        "envKey": "UTTAPEN_API_KEY",
        "baseUrl": "https://api.uttapen.ir/v1",
        "generationConfig": {
          "contextWindowSize": 262144,
          "samplingParams": { "max_tokens": 8192 }
        }
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "anthropic/claude-sonnet-5" }
}

• id همان شناسهٔ مدل در یوتاپن است؛ شناسه‌های دارای / پذیرفته‌اند. آن‌ها را از فهرست مدل‌ها بردار.
• envKey نام متغیر محیطی است، نه خود کلید. کلید sk-up-… را در همان متغیر export کن یا در فایل .env پروژه بگذار و .env را در .gitignore نگه دار.
• samplingParams.max_tokens سقف خروجی هر درخواست است و همان عددی است که ما برایش رزرو می‌کنیم (قیمت‌گذاری). 8192 برای کار روی کد منطقی است؛ عدد بزرگ فقط موجودی‌ات را قفل می‌کند.
• contextWindowSize را روی context واقعی مدل یا کمتر بگذار.
• wireApi را ننویس؛ نبودنش یعنی Chat Completions. اگر wireApi: "responses" بگذاری، درخواست به مسیری می‌رود که یوتاپن ندارد و 404 می‌گیری.

بعد از این، با /model داخل خود ابزار بین مدل‌ها جابه‌جا می‌شوی.

هزینه را کنترل کن

• برای Qwen Code یک کلید جدا با سقف ماهانه بساز (کلیدها) تا مصرفش در داشبورد ← مصرف جدا دیده شود.
• برای کارهای سبک، یک ورودی دیگر با مدل ارزان مثل openai/gpt-5-nano یا google/gemini-2.5-flash-lite و max_tokens کوچک اضافه کن و با /model به آن سوییچ کن.

عیب‌یابی

اگر موجودی قابل‌استفاده هزینهٔ کل max_tokens را پوشش ندهد، یوتاپن به‌جای رد کردن درخواست سقف را تا اندازهٔ موجودی کم می‌کند (کف ۱٬۰۲۴ توکن) و عدد نهایی را در هدر X-Uttapen-Max-Tokens می‌گذارد؛ پاسخ ممکن است با finish_reason برابر length ناتمام بماند. 402 فقط وقتی است که همان کف هم نگنجد.

ابزارهای دیگر در یکپارچه‌سازی و کدهای خطا در خطاها.