千問 API Key 怎麼獲取：阿里雲百煉開通、免費額度與 OpenAI 兼容調用

適用於誰

• 搜「千問 api key」「千問 api key怎麼獲取」「百煉 api key獲取」「千問怎麼用api」「千問免費額度怎麼用」的開發者；
• 想把千問模型接進自己的程序，或接進 Chatbox、Cline、Dify 這類工具的人；
• 擔心免費額度用完後被自動扣費的人。

本文根據阿里雲百煉（Model Studio）幫助中心的五篇官方文檔整理，資料核對於 2026-10-11。模型價格沒有在這幾篇文檔裏列出，本文不寫價格數字，以百煉控制台模型廣場為準。

結論先說

1. 千問 API 在阿里雲百煉上開通，不是在千問 App 裏。用阿里雲主帳號進入百煉控制台，同意協議即開通。
2. API Key 在控制台的 API Key 頁面創建，先在右上角選地域。各地域的 Key、接入域名、模型列表相互獨立，不能混用。
3. 調用方式兼容 OpenAI SDK：改 api_key、base_url、model 三處即可。
4. 新人免費額度：僅華北 2（北京）地域有；每個模型單獨計算，通常為 100 萬 Token，有效期 90 天。
5. 怕被扣費就打開「免費額度用完即停」：額度耗盡後請求會被拒絕而不是轉為按量付費。

步驟

1. 開通百煉

1. 沒有阿里雲帳號先註冊；
2. 用主帳號進入阿里雲百煉控制台，閱讀並同意協議後自動開通。沒有彈出協議說明已經開通過；
3. 如果提示尚未實名認證，按提示完成認證。

關於實名：免費額度文檔寫的是首次開通即自動發放新人額度，未實名認證的用戶也能使用，但系統會強制開啟「用完即停」，額度用完後必須完成認證並充值才能繼續。

2. 創建 API Key

1. 打開控制台的 API Key 頁面，在右上角選擇地域（國內一般選華北 2（北京））；
2. 點「創建 API Key」；
3. 歸屬帳號預設是主帳號，歸屬業務空間預設是「預設業務空間」；
4. 權限建議選「全部」。需要精細控制時選「自定義」，可以限制可訪問的 IP 和可調用的模型範圍；
5. 確定後在列表裏點複製圖標拿到 Key。

官方文檔寫明的幾條規則：

• 創建時不需要選模型，調用時用 model 參數指定；
• API Key 沒有失效時間；主動刪除後立即失效且不可恢復；
• 每個帳號在每個地域最多 50 個 Key；
• 預設業務空間的 Key 可以調用所有標準模型；子業務空間的 Key 只能調用已授權的模型。

3. 把 Key 放進環境變量

官方建議不要把 Key 寫在代碼裏，環境變量名是 DASHSCOPE_API_KEY。

bash
# macOS / Linux（寫入 ~/.zshrc 或 ~/.bashrc 後重新打開終端）
export DASHSCOPE_API_KEY="sk-你的Key"

# Windows PowerShell（用戶級，設定後重新打開窗口）
[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "sk-你的Key", "User")

設定後要重新打開終端或重啟 IDE 才會生效；用 sudo 運行腳本時預設不繼承用戶環境變量，官方給的辦法是加 -E。

4. 選對 Base URL

官方的 Base URL 總覽把按量付費的地址分成兩類：

{WorkspaceId} 要換成你的業務空間 ID，在控制台的業務空間管理頁面查看。其他地域各有自己的地址，例如新加坡的 DashScope 域名是 https://dashscope-intl.aliyuncs.com/compatible-mode/v1，完整列表見官方 Base URL 總覽。

第一次試用、在第三方工具裏填地址，用 DashScope 域名最省事；上生產再換成專屬域名。

5. 發出第一個請求

Python 需要 3.9 或以上版本，安裝 OpenAI SDK：

bash
pip install -U openai

新建 hello_qwen.py：

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 華北2（北京）的 DashScope 域名；用專屬域名時換成帶 WorkspaceId 的地址
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
)

completion = client.chat.completions.create(
    model="qwen3.8-max",  # 以官方模型列表為準
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "用三句話介紹你自己"},
    ],
)
print(completion.choices[0].message.content)

運行 python hello_qwen.py，能打印出回覆就說明通了。

模型名怎麼填：核對時官方模型列表「文本生成」一欄排在前面的是 qwen3.8-max、qwen3.7-plus、qwen3.8-flash，同一平台上還有 DeepSeek、Kimi、GLM 等第三方模型。模型更新很快，以模型列表頁面為準。

6. 接進第三方工具

在 Chatbox、Cline、Dify 這類工具裏通常只要填三樣：API Key、Base URL、模型名稱。官方文檔為 Dify、Chatbox、Cline、Claude Code、Postman 分別提供了配置說明。

要注意的是百煉還有 Coding Plan、Token Plan 這類訂閱方案，它們用的是另一套專屬 Key 和專屬 Base URL。官方寫明 Base URL 必須和同一計費方案的 Key 配套，否則會報 401。

常見問題

Q：免費額度有多少、能用多久？

按官方的新人免費額度文檔：僅華北 2（北京）地域的模型有；每個模型的額度相互獨立，通常為 100 萬 Token，輸入和輸出共用；有效期 90 天，從開通百煉、模型發佈或模型申請通過之日起算，以較晚者為準；過期不補發。個別模型的額度不同，在控制台的免費額度頁面或模型詳情頁查看。

Q：免費額度用完會自動扣錢嗎？

已實名認證的帳號預設會自動轉為按量付費。不想被扣費，就提前開啟「免費額度用完即停」：額度耗盡後請求返回 403，不再計費。官方同時提醒生產環境不建議開啟，以免服務中斷；這個開關關閉後大約需要半小時生效。

Q：報 Model.AccessDenied？

官方的解釋是用了子業務空間的 Key，而該空間沒有這個模型的調用授權。讓主帳號管理員給子空間授權，或改用預設業務空間的 Key。

Q：報 401？

先檢查三樣是否配套：Key 所屬的地域、Base URL 的地域、計費方案。北京地域的 Key 不能配新加坡的地址，訂閱方案的 Key 不能配按量付費的地址。

Q：環境變量設了還是讀不到？

常見原因：只在當前窗口臨時設定；設定後沒有重新打開終端或 IDE；程序由 systemd 等服務管理器啟動，需要在服務配置裏單獨加。

Q：可以把 Key 寫在網頁前端或 App 裏嗎？

官方明確不建議在瀏覽器、流動應用等客戶端使用長期有效的 Key，應改用臨時 API Key，有效期最長 1800 秒。

Q：和 DeepSeek、Kimi 的 API 比呢？

調用方式都兼容 OpenAI SDK，區別主要在模型、價格和限流。可以對照《DeepSeek API Key怎麼獲取》《Kimi API怎麼用》。

參考資料

• 阿里雲百煉：首次調用千問 API — https://help.aliyun.com/zh/model-studio/first-api-call-to-qwen
• 阿里雲百煉：獲取 API Key — https://help.aliyun.com/zh/model-studio/get-api-key
• 阿里雲百煉：Base URL 總覽 — https://help.aliyun.com/zh/model-studio/base-url
• 阿里雲百煉：新人免費額度與用完即停規則 — https://help.aliyun.com/zh/model-studio/new-free-quota
• 阿里雲百煉：模型列表 — https://help.aliyun.com/zh/model-studio/models