更新模型授權 - Alibaba Cloud Model Studio

前提條件

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

請求說明

HTTP 方法：POST
請求地址
調用時請將 {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`

請求參數

所有參數均通過請求 Body 傳遞。

參數	類型	必選	描述
models	Array[Object]	條件必填	逐模型授權項列表。當 `access_all_entities` 為 `OPEN`/`CLOSE` 時可空；為 `KEEP` 或不傳時必填，且數量需為 1~20。樣本：`[{"model":"qwen-plus","inference":true}]`
models[].model	String	是	模型 ID，不可為空。如 `qwen-plus`、`qwen3-max`。
models[].inference	Boolean	否	模型調用許可權。`true`=授權推理，`false`=取消授權，不傳=保持現狀。預設值：null（不變更）。
models[].finetune	Boolean	否	模型訓練許可權。`true`=授權微調，`false`=取消，不傳=保持現狀。預設值：null（不變更）。
models[].deploy	Boolean	否	模型部署許可權。`true`=授權部署，`false`=取消，不傳=保持現狀。預設值：null（不變更）。
access_all_entities	String	否	一鍵授權開關。可選值： `OPEN`：一鍵授權當前空間全部推理模型（含後續新增）。 `CLOSE`：取消一鍵授權並清空歷史推理授權。 `KEEP`：保持原逐模型授權行為（預設）。傳 `OPEN`/`CLOSE` 時 `models` 可不填。預設值：`KEEP`。樣本：`OPEN`

返回參數

參數	類型	描述
request_id	String	請求 ID。樣本：`d5f5201f-ee7a-9e3d-8569-bc0eedec21f9`
code	String	錯誤碼，成功為 `null`。
message	String	錯誤資訊，成功為 `null`。
success	Boolean	是否成功。樣本：`true`
output	Object	業務資料，本介面為 `null`。

請求樣本

樣本一：逐模型授權

curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/permissions" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{
        "models": [
            {"model": "qwen-plus", "inference": true, "fine_tune": true, "deploy": false},
            {"model": "qwen3-max", "inference": true}
        ]
    }'

樣本二：一鍵授權

curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/permissions" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{"access_all_entities": "OPEN"}'

返回樣本

成功樣本

{
    "code": null,
    "message": null,
    "success": true,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

失敗樣本

{
    "code": "InvalidParameter",
    "message": "Model qwen-xxx is not authorized for Inference",
    "success": false,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

錯誤碼

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

​前提條件

​請求說明

​請求參數

​返回參數

​請求樣本

​返回樣本

​錯誤碼

前提條件

請求說明

請求參數

返回參數

請求樣本

返回樣本

錯誤碼