全部產品
Search
文件中心

Alibaba Cloud Model Studio:擷取API Key

更新時間:Oct 16, 2025

使用阿里雲百鍊的大模型或應用前,請先開通阿里雲百鍊,並擷取API Key作為鑒權憑證。

一、開通阿里雲百鍊的模型服務

使用阿里雲主帳號訪問阿里雲百鍊大模型服務平台(新加坡北京,如果頁面頂部顯示開通提示,您需開通阿里雲百鍊模型服務,以獲得新人免費額度。開通阿里雲百鍊不會產生費用,僅模型調用(超出免費額度後)會產生相應計費。如果頁面頂部未顯示開通提示,則表示您已經開通。

二、擷取API Key

重要

需使用主帳號,或具備管理員API-Key頁面許可權子帳號操作。

開通阿里雲百鍊後,您需要手動建立API Key,系統不會自動產生。

  1. 前往密鑰管理新加坡北京頁面,在API-Key頁簽(下圖位置①)下單擊建立API-KEY(下圖位置②)。

    image

  2. 建立API-KEY彈窗中,選擇API Key的歸屬帳號歸屬業務空間,填寫描述,並單擊確定

    • 歸屬帳號:可選擇主帳號或子帳號(當人員離職或崗位變動時,只需將其子帳號移出業務空間,對應API Key將自動失效,不再具備調用許可權)。

    • 歸屬業務空間:通常選擇預設業務空間(或主帳號空間)。若需管控某類使用者可調用的模型,或對模型調用的費用進行分賬,請建立/挑選清單中的子業務空間。詳見子業務空間的模型調用。(單個業務空間最多支援建立 20 個 API Key)

      說明

      API Key的調用許可權完全由其歸屬業務空間決定。同一空間內的API Key許可權相同,無需為不同模型(如文生文、文生圖、語音合成)建立不同的API Key。

      • 預設業務空間下的API Key:可調用所有標準模型,以及預設業務空間內的應用

      • 子業務空間下的API Key:可調用該子業務空間已獲得授權的標準模型,以及該子業務空間內的應用。

  3. 點擊API Key旁的image表徵圖(上圖位置③)擷取該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均將失效,無法再用於模型調用。