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

> 說明 Qwen Code API 金鑰是什麼、與訂閱方案有何不同、在哪裡申請、如何設定 settings.json，以及哪些因素會決定 Token 用量。

Source: https://ailoot.ai/blog/zh-hant-tw/qwen-code-api-key/
Canonical: https://ailoot.ai/blog/zh-hant-tw/qwen-code-api-key/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-141
Revision: sha256-00581109cb788ed36a95ec931268eff7fe78cf1bb1a4bbb5df4f336920c9be19


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

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

<div class="aside" data-semantic="callout" role="note" aria-label="注意">

注意

本文僅供資訊參考，並說明公開規則。不會列出聲稱可以在規避限制的情況下「代辦」付款的中介服務，也不會說明規避限制的方法。價格取自供應商截至 2026 年 9 月初的頁面；價格會變動，請至供應商網站查看目前價格。

</div>

<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Ailoot 文件">

[Ailoot 文件](https://ailoot.ai/docs/) — 使用這項服務的參考資料。

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重點摘要">

重點摘要

Qwen Code 的 API 金鑰是一串類似個人密碼的字串，服務供應商會用它識別你對模型提出的請求並計算用量。Qwen Code 本身是免費的開源代理程式，並未內建自己的模型。它會從外部供應商取得回覆，並在該處提供你的金鑰。因此，「取得金鑰」就是向供應商註冊，並在其帳戶中申請存取字串。請由啟動環境提供秘密值，在 Qwen Code 設定中只參照變數名稱。成功的模型請求才確認存取可用，單純儲存設定並不能證明，而且實際請求可能產生用量費用。

</div>

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重點摘要">

重點摘要

Qwen Code 支援多種驗證與計費途徑。舊有免費 Qwen OAuth 已於 2026 年 4 月 15 日停用。Alibaba Coding Plan 採訂閱制並使用專用端點；標準 Model Studio API 金鑰則採隨用隨付。目前用戶端也提供其他平台與方案選項。本指南只說明標準 Model Studio API 金鑰途徑；區域、端點、模型與計費方案必須彼此對應。

</div>

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

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

<figure>
<blockquote>
<p>免費的 Qwen OAuth 方案已於 2026 年 4 月 15 日停用。先前儲存的 Token 可能還能使用一段時間，但新的請求會遭到拒絕。</p>
</blockquote>
<figcaption>— Qwen Code 文件，驗證，官方文件</figcaption>
</figure>

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重點摘要">

重點摘要

Qwen Code 可以連接多種供應商與協定。直接連接 Alibaba Model Studio 時，請先在控制台選擇區域，再建立金鑰。金鑰、API Base URL、工作區及可用模型必須屬於相同區域。國際版控制台網址或英文介面，本身不能判定 API 區域。

</div>

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

<figure>
<blockquote>
<p>支援 OpenAI、Anthropic、Gemini 和 Qwen 通訊協定。可使用任何第三方供應商或本機模型。隨時切換。</p>
</blockquote>
<figcaption>— Qwen Code 文件，驗證，官方文件</figcaption>
</figure>

以下是直接連線的方式。

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

| 建立金鑰時選擇的區域 | 標準 OpenAI 相容 Base URL | 應確認的項目 |
|----|----|----|
| 中國（北京） | `DASHSCOPE_BASE_URL` | 北京金鑰與該區域提供的模型 |
| 新加坡 | `DASHSCOPE_BASE_URL` | 新加坡金鑰與該區域提供的模型 |
| 美國（維吉尼亞），含 Global 或 US 部署範圍 | 從所選美國工作區複製 API Host，使用其官方說明的 OpenAI 相容 Base URL | 美國工作區金鑰、部署範圍與模型清單；不可重用北京或新加坡網址 |

[區域指南](https://www.alibabacloud.com/help/en/model-studio/regions)建議正式環境使用工作區專屬網域。請從 Workspace Management 複製實際 API Host，並遵循 [Base URL 指南](https://www.alibabacloud.com/help/en/model-studio/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](https://ailoot.ai/blog/zh-hant-tw/qwen-code-terminal-auto-edit/)的操作指南。



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重點摘要">

重點摘要

在 `~/.qwen/settings.json` 設定協定、區域對應的 Base URL、模型 ID，以及提供金鑰的環境變數名稱 `envKey`。秘密值不要放進 JSON。從持有該變數的同一終端機啟動 Qwen Code，確認所選連線並傳送一個短提示詞，再判斷設定是否可用。`/model` 顯示已設定的選項，本身不能證明供應商存取成功。

</div>

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

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

```json
{
  "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`。[模型供應商參考文件](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/)有說明這些欄位。

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

```bash
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：

```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 金鑰的費用是多少？哪些因素會讓帳單增加？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重點摘要">

重點摘要

使用 API 金鑰採用計量計費：輸入和輸出 Token 各按每千個計價，沒有固定月費。Qwen3-Coder-Flash 等輕量模型便宜數倍。工作量越大，帳單越高：檔案越長，代理程式讀寫越多，用量就越高。請務必查看供應商頁面上的確切價格；價格會變動。

</div>

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

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

實際上，帳單取決於代理程式處理的文字量。長檔案、長工作階段，以及反覆讀取程式碼，最容易快速耗盡餘額；任務數量則是次要因素。另一篇文章逐步說明了 [API Token 用量的計算方式](https://ailoot.ai/blog/zh-hant-tw/api-token-usage-calculation/)，以及用量為何會在不知不覺中耗盡。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重點摘要">

重點摘要

要開始使用金鑰付費，必須先儲值。如果付款系統因為發卡銀行而拒絕你的卡片，變更電子郵件、語言或個人檔案設定並不會改變該卡片的付款條件。

</div>

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

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

如果拒付與發卡銀行有關，變更電子郵件、介面語言或個人檔案設定並不會改變付款條件。本文以[Claude 使用外國發行的卡片](https://ailoot.ai/blog/zh-hant-tw/claude-card-payment-requirements/)為例說明這項機制。

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

## 該從哪裡開始？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重點摘要">

重點摘要

先區分舊有免費 OAuth、Coding Plan 與標準 Model Studio API；這不是完整驗證選單。標準 API 的金鑰、端點、模型及計費應對應同一區域與工作區。建立金鑰與準備使用資金是兩件事。秘密值不要放進設定 JSON，請從啟動終端機提供，再以簡短回覆驗證。

</div>

簡要步驟如下：

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](https://ailoot.ai/blog/zh-hant-tw/qwen-code-token-plan-setup/)的操作指南說明 Qwen Code 與其他終端機代理程式有何不同。

<div class="section" role="doc-bibliography" aria-label="來源">

### 來源

- [Qwen Code - GitHub 儲存庫](https://github.com/QwenLM/qwen-code) - 開源代理程式程式碼、安裝方式、多通訊協定支援，以及連接第三方供應商的資訊
- [Qwen Code - 驗證文件](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) - 驗證途徑、舊有免費 OAuth 停用，以及 Model Studio 與方案專用連線的區別
- [Alibaba Cloud ModelStudio - 控制台](https://bailian.console.alibabacloud.com) - 申請 Qwen 模型金鑰的國際版帳戶

</div>



更多資料請參閱 [Ailoot](https://ailoot.ai/)。

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

### 建立 API 金鑰，就等於購買模型用量嗎？

不是。核發存取字串與為用量儲值是兩件事。供應商透過金鑰辨識並計量請求，但只有金鑰，不能證明帳戶有可用餘額或額度。

### Qwen Code 的供應商設定，哪些欄位必須對應？

所選協定、供應商 Base URL、保存金鑰的環境變數及模型識別碼，必須指向同一連線。範例中 model.name 應符合 modelProviders 項目的 id；分享設定副本時不要放實際金鑰。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。