全部產品
Search

搜尋本產品

    Alibaba Cloud Model Studio：擷取API Key

    文件中心

    Alibaba Cloud Model Studio：擷取API Key

    更新時間：Mar 26, 2026

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

    一、擷取API Key

    重要

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

    新加坡等其他地區

    1. 前往阿里雲百鍊控制台首頁，在頁面右上方選擇目標地區，進入API Key頁面，單擊创建API KEY。

    2. 在彈窗中配置以下資訊，並單擊确定：

      • 归属账号：建議選擇主帳號（账号列內容為純數字帳號ID）。

      • 归属业务空间：建議選擇預設業務空間。

    3. 點擊API Key旁的image表徵圖擷取該API Key。

      主帳號可以查看全部API Key，子帳號僅能查看自己建立的API Key。

      2026-02-11_11-56-27

    華北2（北京）地區

    1. 前往阿里雲百鍊控制台首頁，在頁面右上方選擇华北2（北京）地區，進入API Key頁面，單擊创建API KEY。

    2. 在彈窗中配置以下資訊，並單擊确定：

      • 归属业务空间：建議選擇預設業務空間。

      • 許可權：建議選擇全部，若有更精細的許可權控制需求，可以選擇自訂來控制使用 API Key 的 IP 白名單。

      如何選擇 API Key 的許可權配置？

      阿里雲百鍊提供兩種類型的許可權配置，請根據實際需求進行選擇：

      • 全部：授予該 API Key 調用所有模型與應用的許可權。

      • 自訂：按需勾選特定模型或應用，實現最小許可權原則。您可以配置：

        • IP 訪問白名單：僅允許清單內的 IP 使用該 API Key 發起調用（支援 IPv4、IPv6 與網段）。

    3. 點擊API Key旁的image表徵圖擷取該API Key。

      主帳號可以查看全部API Key，子帳號僅能查看自己建立的API Key。

      image

    何時選擇其他歸屬帳號或業務空間？

    如果您有團隊協作或成本分攤需求，可以瞭解以下概念：

    • 歸屬業務空間：用於隔離不同專案或團隊的資源和許可權。若需管控某類使用者可調用的模型，或對模型調用的費用進行分賬，請建立/挑選清單中的子業務空間。

    詳情請參見API-Key 許可權以及賬單查詢與成本管理。

    二、使用API Key

    說明

    Coding Plan應使用專屬 API Key（格式：sk-sp-xxxxx），而非本文介紹的百鍊通用 API Key（格式：sk-xxxxx）。擷取 Coding Plan 專屬 API Key 請參見擷取套餐專屬 API Key 和 Base URL。

    • 方式一：在第三方工具中調用模型

      如果在Chatbox等工具或平台中調用模型，您可能需要輸入三個資訊：

      • 本文擷取的API Key

      • API Key所屬地區的Base URL：

        • 新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1

        • 美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1

        • 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1

        • 中国香港：https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1

        • 德国（法兰克福）：https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/compatible-mode/v1，調用時請將WorkspaceId替換為真實的業務空間ID。

      • 模型名稱，如qwen-plus

    常用工具配置：Chatbox、Cline、Claude Code、Dify、OpenClaw（原 Clawdbot/Moltbot）、Postman、Qwen Code。

    請勿以任何方式公開API Key，避免因未經授權的使用導致安全風險或資金損失。

    API Key許可權說明

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

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

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

    說明

    目前僅華北2（北京）地區支援為 API Key 配置更精細的許可權控制。

    您可以在建立 API Key 或點擊已有 API Key 操作列的編輯時，將許可權切換為自訂，即可配置：

    • IP 訪問白名單：僅允許清單內的 IP 使用該 API Key 發起調用（支援 IPv4、IPv6 與網段）。

    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均將失效，無法再用於模型調用。