更新模型授权 - 阿里云百炼

前提条件

已创建 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"
}

错误码

如果调用失败，会返回错误信息。更多错误码及解决方法，请参见错误信息。

​前提条件

​请求说明

​请求参数

​返回参数

​请求示例

​返回示例

​错误码

前提条件

请求说明

请求参数

返回参数

请求示例

返回示例

错误码