使用阿里雲百鍊的大模型或應用前,請先開通阿里雲百鍊,並擷取API Key作為鑒權憑證。
一、開通阿里雲百鍊的模型服務
使用阿里雲主帳號訪問阿里雲百鍊大模型服務平台(新加坡或北京),如果頁面頂部顯示開通提示,您需開通阿里雲百鍊模型服務,以獲得新人免費額度。開通阿里雲百鍊不會產生費用,僅模型調用(超出免費額度後)會產生相應計費。如果頁面頂部未顯示開通提示,則表示您已經開通。
二、擷取API Key
開通阿里雲百鍊後,您需要手動建立API Key,系統不會自動產生。
前往密鑰管理(新加坡或北京)頁面,在API-Key頁簽(下圖位置①)下單擊建立API-KEY(下圖位置②)。

在建立API-KEY彈窗中,選擇API Key的歸屬帳號及歸屬業務空間,填寫描述,並單擊確定。
歸屬帳號:可選擇主帳號或子帳號(當人員離職或崗位變動時,只需將其子帳號移出業務空間,對應API Key將自動失效,不再具備調用許可權)。
歸屬業務空間:通常選擇預設業務空間(或主帳號空間)。若需管控某類使用者可調用的模型,或對模型調用的費用進行分賬,請建立/挑選清單中的子業務空間。詳見子業務空間的模型調用。(單個業務空間最多支援建立 20 個 API Key)
點擊API Key旁的
表徵圖(上圖位置③)擷取該API Key。主帳號可以查看全部API Key,子帳號僅能查看自己建立的API Key。
三、使用API Key
方式一:在第三方工具中調用模型
如果在Chatbox等工具或平台中調用模型,您可能需要輸入三個資訊:
本文擷取的API Key
Base URL:
https://dashscope-intl.aliyuncs.com/compatible-mode/v1如果使用華北2(北京)地區的模型,需要將url替換為:https://dashscope.aliyuncs.com/compatible-mode/v1
模型名稱,如qwen-plus
方式二:通過代碼調用模型
如果通過代碼調用模型,建議配置API Key到環境變數,避免將API Key明文寫在代碼中,從而降低泄漏風險。
請勿以任何方式公開API Key,避免因未經授權的使用導致安全風險或資金損失。
API Key時效性說明
建立的API Key永久有效,手動刪除後即失效。
若需為第三方應用或使用者提供臨時存取權限,或需嚴格控制敏感性資料訪問、刪除等高風險操作,可產生臨時 API Key(有效期間60秒),避免暴露長期有效API Key,降低泄露風險。
常見問題
Q:單個主帳號下最多能建立多少個API Key?
A:每個主帳號下最多可建立10個業務空間(包括預設業務空間),每個業務空間下最多可建立20個API Key。
Q:RAM使用者被刪除後,其建立的API Key是否依然可用?
A:在RAM控制台中刪除RAM使用者後,其建立的所有API Key均將失效,無法再用於模型調用。