Qwen Code API 金鑰：申請地點、連接方式與用量計算

有人安裝 Qwen Code，在終端機中啟動後，第一次發出請求就被要求提供金鑰。接著便開始搜尋：人們輸入「購買 qwen code api 金鑰」，結果進入一些銷售訂閱方案或他人現成存取權的頁面。以下將逐步說明金鑰是什麼、要去哪裡取得，以及費用是多少。

先說重點：API 金鑰不是單獨裝盒販售的商品。它是你在模型供應商帳戶中自行申請的存取字串，申請免費。之後儲值時才需要付費；該步驟適用供應商的條款。下文將說明去哪裡取得金鑰、如何將它連接到 Qwen Code，以及使用費用。

Qwen Code 的 API 金鑰究竟是什麼？#

Qwen Code 是一款在終端機中執行、為你的工作撰寫程式碼的開源 AI 代理程式。它免費，可透過 npm 安裝，內部沒有自己的神經網路。所有智慧處理都由模型執行，而模型運行在供應商的伺服器上。

Qwen Code 需要通行證才能連接模型。這張通行證就是 API 金鑰——一串由供應商個別發給你的長字串，類似密碼。代理程式送出請求時會附上金鑰；供應商用它識別請求者、傳回回覆，並從你的餘額扣除用量費用。

這帶出一個簡單的重點，可以釐清一半的混淆。金鑰不是當作市集商品購買的：你只要建立供應商帳戶、按下「建立金鑰」，就能免費取得字串。搜尋「購買 api 金鑰」實際上是在問「要去哪裡建立帳戶，以及之後如何支付使用費」；下文會回答這兩個問題。

API 金鑰與訂閱方案及舊有免費登入有何不同？#

在 Qwen Code 工作階段內執行 /auth，會顯示已安裝版本支援的驗證選項。請選擇符合金鑰核發平台與計費方案的項目。下文區分舊有免費登入、Coding Plan，以及本指南使用的標準 API 金鑰，並非完整列出目前選單的所有項目。

第一個選項是透過 Qwen 帳戶免費登入（Qwen OAuth）。過去不需要金鑰就能使用模型，但此方式已停用。

第二個選項是 Alibaba ModelStudio 的 Coding Plan 訂閱方案。它採固定月費，提供每週請求配額和專用的連線網址。

第三個選項是模型供應商提供的 API 金鑰。沒有固定費用：你將款項存入餘額，再依 Token 用量隨用隨付。這種方式彈性較高，適合不定期使用代理程式的人。本文接下來將聚焦於此方式。

可以在哪裡申請 Qwen Code 的 API 金鑰？#

由於 Qwen Code 支援不同通訊協定，你不必只向一家供應商申請金鑰。官方文件明確列出它可以連接的服務。

以下是直接連線的方式。

直接連接時，開啟 Alibaba Model Studio 控制台，選定區域，再到 API 金鑰管理頁面建立金鑰。將區域與工作區名稱連同設定保留，不要把金鑰複製到共用筆記。

區域指南建議正式環境使用工作區專屬網域。請從 Workspace Management 複製實際 API Host，並遵循 Base URL 指南，不要編造工作區 ID。既有共用 DashScope 端點與工作區專屬端點，是不同的存取選擇。Coding Plan 和 Token Plan 也使用各自的端點及金鑰。請從所選區域的工作區控制台複製完整的 OpenAI 相容 Base URL 至 DASHSCOPE_BASE_URL。JSON 省略 baseUrl，啟動前透過 OPENAI_BASE_URL 提供網址。請使用控制台的實際值，不可將工作區 ID 的預留文字直接當成真實值。

還有一種免費選擇，不需要任何金鑰：透過 Ollama 在自己的電腦上執行 Qwen 模型，並將 Qwen Code 連接到它，當作自己的伺服器使用。這需要效能強大的電腦，並且要另外設定。如何在本機執行代理程式，請參閱在終端機中啟動 Qwen Code的操作指南。

如何將金鑰加入 Qwen Code，讓它開始運作？#

先備份既有設定，再將下列連線合併到 ~/.qwen/settings.json；不要覆寫不相關的供應商或偏好。此示意設定依循 Qwen Code 官方驗證範例，透過 OPENAI_BASE_URL 傳入工作區 URL，從 envKey 指定的環境變數讀取 API 金鑰，並省略明文 env 區塊。qwen3-coder-plus 是該官方範例中的模型；先確認你的區域與帳戶可用，否則在兩處都改用該區域控制台提供的實際模型 ID。

請從所選區域的工作區控制台複製完整的 OpenAI 相容 Base URL 至 DASHSCOPE_BASE_URL。JSON 省略 baseUrl，啟動前透過 OPENAI_BASE_URL 提供網址。請使用控制台的實際值，不可將工作區 ID 的預留文字直接當成真實值。

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

openai 選擇相容協定。envKey 是 Qwen Code 讀取的變數名稱，不是金鑰值。model.name 必須符合設定的 id。模型供應商參考文件有說明這些欄位。

macOS 或 Linux 請開啟 Bash 終端機，在隱藏輸入提示輸入金鑰，再由同一終端機啟動 Qwen Code：

read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi

Windows 請使用 PowerShell：

$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen

這些指令不會將實際秘密值寫入 JSON 或 shell 指令歷史；執行中的程序仍會透過環境變數取得它。不要列印、提交到版本控制或貼進提示詞。改用此途徑時，請移除設定中舊有含秘密的 env 項目。新終端機需再次提供變數。

在 Qwen Code 使用 /doctor 檢查驗證，並以 /model 查看設定選項。在無害的空白測試資料夾傳送：「只回覆 connected 這個字。不要讀取或修改檔案，也不要執行指令。」成功回覆會測試一次模型請求，可能產生用量費用。/model 出現模型，只確認了本機設定。

請求失敗時，記錄已遮蔽秘密的錯誤，以及供應商提供的請求 ID。驗證與模型可用性、帳務應分開檢查：在同一供應商控制台確認金鑰核發平台、區域／工作區、標準或方案專用端點、模型 ID，以及帳戶餘額／額度。401 也可能是金鑰與端點或計費方案不符，不能當作供應商故障的證據。檢查失敗後先停止，依文件修正已確認的不符之處再重試。本文是依文件整理的範例，並非為本指南執行過的付費請求。

使用 API 金鑰的費用是多少？哪些因素會讓帳單增加？#

API 金鑰與訂閱方案的不同之處在於，沒有固定月費。你依模型讀取和寫入的內容量付費，並以 Token 計量。Token 是一小段文字，長度大約相當於幾個字母。每個模型都有各自的輸入 Token 和輸出 Token 每百萬個價格，而輸出的費用幾乎總是高於輸入。

一百萬個 Token 聽起來很多，但在大型專案中，消耗速度會比預期快：代理程式每次收到請求時都會完整讀取你的檔案。

實際上，帳單取決於代理程式處理的文字量。長檔案、長工作階段，以及反覆讀取程式碼，最容易快速耗盡餘額；任務數量則是次要因素。另一篇文章逐步說明了 API Token 用量的計算方式，以及用量為何會在不知不覺中耗盡。

為什麼付款會遭到拒絕？#

常見的錯誤就在這裡發生。

問題會在下一個步驟出現。你已經申請金鑰，但如果餘額不足，就無法使用任何服務；供應商會回傳餘額不足錯誤。

如果拒付與發卡銀行有關，變更電子郵件、介面語言或個人檔案設定並不會改變付款條件。本文以Claude 使用外國發行的卡片為例說明這項機制。

另外請記住，最終決定權在付款閘道。它可能基於自身原因拒絕付款，因此無法保證交易一定會成功。

該從哪裡開始？#

簡要步驟如下：

1. 區分舊有免費 OAuth、Coding Plan 與標準 Model Studio API。舊有免費 OAuth 已於 2026 年 4 月停用。本指南說明標準 API 隨用隨付途徑，並非完整列出目前的驗證選項。
2. 建立供應商帳戶。最簡單的選擇是直接使用 Alibaba。
3. 在供應商帳戶的存取金鑰區段申請金鑰。申請免費，不需要為此提供卡片。
4. 將區域對應連線合併到 ~/.qwen/settings.json，不放入秘密值。在啟動終端機提供 DASHSCOPE_API_KEY，再依上文確認所選模型及一次簡短回覆。
5. 要支付使用費，必須使用以你本人名義發行、且供應商付款閘道接受的卡片。儲值條件由付款閘道設定；申請金鑰和支付使用費是兩個不同的步驟。

也值得考慮你需要哪種模型。高難度任務可選擇較高階的 Qwen3-Coder-Plus；若想省錢，則可選擇較輕量的 Flash，相同用量下便宜數倍。以 Qwen Code 取代 Claude Code的操作指南說明 Qwen Code 與其他終端機代理程式有何不同。

更多資料請參閱 Ailoot。