產生臨時API Key

在瀏覽器、移動 App 等不可信環境中調用模型服務時，通過安全的後端服務產生臨時API Key，避免永久API Key 泄露。

重要

臨時API Key 繼承產生它的API Key 所擁有的全部許可權，包括對特定模型或知識庫的訪問限制。

前提條件

在密鑰管理（新加坡）、密鑰管理（維吉尼亞）、密鑰管理（北京）或密鑰管理（中國香港）頁面建立永久API Key，並將其配置為環境變數 DASHSCOPE_API_KEY。配置方法請參見配置API Key 到環境變數。

請求樣本

臨時API Key 預設有效期間為 60 秒，支援通過 expire_in_seconds 參數設定有效期間（TTL），範圍為 [1, 1800] 秒。

各地區的API Key 不同。

以下樣本使用新加坡地區的 Endpoint，調用時請將WorkspaceId替換為真實的業務空間ID。如需使用北京地區，請將URL替換為：https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800

# 以下為新加坡地區URL，調用時請將WorkspaceId替換為真實的業務空間ID，各地區的URL不同。
curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"

響應樣本

正常響應樣本

{  
    "token":"st-****",
    "expires_at":1744080369
}

響應參數

參數名稱	參數類型	說明	樣本
token	String	產生的臨時API Key。	st-****
expires_at	Number	到期時間，UNIX 時間戳記，單位為秒。	1744080369

錯誤響應樣本

{  
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"902fee3b-f7f0-9a8c-96a1-6b4ea25af114"
}

響應參數

參數名稱	參數類型	說明	樣本
code	String	錯誤碼。更多錯誤原因及解決方案，請前往錯誤碼頁面查詢。	InvalidApiKey：無效API Key
message	String	錯誤資訊。	Invalid API-key provided.
request_id	String	請求 ID。	902fee3b-f7f0-9a8c-96a1-6b4ea25af114

常見問題

問：能否手動刪除已建立的臨時API Key？

答：不能。臨時API Key 具有固定的生命週期，到期後自動失效，無法提前刪除。