查詢模型授權 - Alibaba Cloud Model Studio

前提條件

已建立 API Key 並配置為環境變數 DASHSCOPE_API_KEY。配置方法請參見配置API Key到環境變數。

請求說明

HTTP 方法：GET
請求地址
調用時請將 {WorkspaceId} 替換為您的業務空間 ID。

地區
Endpoint
華北2（北京）
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/permissions
認證方式 在請求 Header 中設定 Authorization: Bearer {API_KEY}。

地區	Endpoint
華北2（北京）	`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/permissions`

請求參數

所有參數均通過 Query String 傳遞。

參數	類型	必選	描述
name	String	否	模型名稱模糊搜尋，對 `name` 與 `model_id` 做模糊比對。樣本：`qwen`
model	String	否	模型 ID 精確查詢，對 `model_id` 做精確匹配。樣本：`qwen-plus`
page_no	Integer	否	頁碼，正整數，從 1 開始。預設值：`1`。
page_size	Integer	否	每頁數量，取值範圍 1~200，最大 200。預設值：`20`。
authorization_scope	String	否	授權範圍篩選。可選值： `AUTHORIZABLE`：可授權的模型（預設）。 `AUTHORIZED`：已授權的模型。預設值：`AUTHORIZABLE`。樣本：`AUTHORIZED`
action	String	否	許可權動作維度。可選值：`INFERENCE`-推理（當前僅支援此值）。僅在 `authorization_scope=AUTHORIZED` 時驅動過濾維度。預設值：`INFERENCE`。

返回參數

參數	類型	描述
request_id	String	請求 ID。樣本：`d5f5201f-ee7a-9e3d-8569-bc0eedec21f9`
code	String	錯誤碼，成功為 `null`。
message	String	錯誤資訊，成功為 `null`。
success	Boolean	是否成功。樣本：`true`
output.total	Number	總數。樣本：`5`
output.page_no	Number	頁碼。樣本：`1`
output.page_size	Number	每頁數量。樣本：`20`
output.permissions	Array[Object]	許可權列表，見返回樣本。
output.model	String	模型 ID。樣本：`qwen-plus`
output.name	String	模型展示名。樣本：`通義千問-Plus`
output.permissions[].permissions	Object	許可權明細。樣本：`{"inference":true,"fine_tune":false,"deploy":false}`。包含以下欄位： `inference`（Boolean）：是否具備模型調用許可權。樣本：`true` `fine_tune`（Boolean）：是否具備模型訓練許可權。樣本：`false` `deploy`（Boolean）：是否具備模型部署許可權。樣本：`false`

請求樣本

curl "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/permissions?authorization_scope=AUTHORIZED&action=INFERENCE&page_no=1&page_size=20" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json'

返回樣本

{
    "code": null,
    "message": null,
    "success": true,
    "output": {
        "total": 3,
        "page_no": 1,
        "page_size": 20,
        "permissions": [
            {
                "model": "qwen-plus",
                "name": "通義千問-Plus",
                "permissions": {
                    "inference": true,
                    "fine_tune": false,
                    "deploy": false
                }
            },
            {
                "model": "qwen3-max",
                "name": "通義千問3-Max",
                "permissions": {
                    "inference": true,
                    "fine_tune": true,
                    "deploy": false
                }
            },
            {
                "model": "qwen-turbo",
                "name": "通義千問-Turbo",
                "permissions": {
                    "inference": true,
                    "fine_tune": false,
                    "deploy": false
                }
            }
        ]
    },
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

錯誤碼

如果調用失敗，會返回錯誤資訊。更多錯誤碼及解決方案，請參見錯誤資訊。

​前提條件

​請求說明

​請求參數

​返回參數

​請求樣本

​返回樣本

​錯誤碼

前提條件

請求說明

請求參數

返回參數

請求樣本

返回樣本

錯誤碼