Listar permisos de modelos - Alibaba Cloud Model Studio - Centro de documentación de Alibaba Cloud

Llame al endpoint GET /api/v1/models/permissions para consultar la lista de modelos autorizables o autorizados y sus detalles de permisos en el espacio de trabajo actual.

Requisitos previos

Se ha creado una clave API y se ha configurado como la variable de entorno DASHSCOPE_API_KEY. Para obtener más información, consulte Configurar una clave API en variables de entorno.

Solicitud

Método HTTP: GET
URL de solicitud

Reemplace {WorkspaceId} con su ID de espacio de trabajo.

Región
Endpoint
China (Beijing)
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/permissions
Autenticación
Establezca Authorization: Bearer {API_KEY} en el encabezado de la solicitud.

Región	Endpoint
China (Beijing)	`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/permissions`

Parámetros de solicitud

Todos los parámetros se pasan a través de la cadena de consulta.

Parámetro	Tipo	Obligatorio	Descripción
name	String	No	Búsqueda difusa por nombre de modelo. Realiza una coincidencia difusa con `name` y `model_id`. Ejemplo: `qwen`
model	String	No	Coincidencia exacta por ID de modelo. Realiza una coincidencia exacta con `model_id`. Ejemplo: `qwen-plus`
page_no	Integer	No	Número de página, un entero positivo que comienza desde 1. Valor predeterminado: `1`.
page_size	Integer	No	Número de entradas por página, con un rango de 1 a 200 (máximo 200). Valor predeterminado: `20`.
authorization_scope	String	No	Filtro de alcance de autorización. Valores válidos: `AUTHORIZABLE`: Modelos autorizables (predeterminado). `AUTHORIZED`: Modelos autorizados. Valor predeterminado: `AUTHORIZABLE`. Ejemplo: `AUTHORIZED`
action	String	No	Dimensión de acción de permiso. Valores válidos: `INFERENCE` - inferencia (actualmente el único valor admitido). Impulsa la dimensión de filtro solo cuando `authorization_scope=AUTHORIZED`. Valor predeterminado: `INFERENCE`.

Parámetros de respuesta

Parámetro	Tipo	Descripción
request_id	String	El ID de la solicitud. Ejemplo: `d5f5201f-ee7a-9e3d-8569-bc0eedec21f9`
code	String	Código de error. `null` en caso de éxito.
message	String	Mensaje de error. `null` en caso de éxito.
success	Boolean	Indica si la llamada fue exitosa. Ejemplo: `true`
output.total	Número	Número total. Ejemplo: `5`
output.page_no	Número	Número de página. Ejemplo: `1`
output.page_size	Número	Número de entradas por página. Ejemplo: `20`
output.permissions	Array[Object]	Lista de permisos. Consulte la respuesta de ejemplo.
output.model	String	El ID del modelo. Ejemplo: `qwen-plus`
output.name	String	Nombre para mostrar del modelo. Ejemplo: `Qwen-Plus`
output.permissions[].permissions	Object	Detalles del permiso. Ejemplo: `{"inference":true,"fine_tune":false,"deploy":false}`. Contiene los siguientes campos: `inference` (Booleano): Indica si el modelo tiene permiso de llamada al modelo. Ejemplo: `true` `finetune` (Booleano): Indica si el modelo tiene permiso de entrenamiento del modelo. Ejemplo: `false` `deploy` (Booleano): Indica si el modelo tiene permiso de implementación del modelo. Ejemplo: `false`

Solicitudes de ejemplo

curl "https://dashscope.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'

Respuesta de ejemplo

{
    "code": null,
    "message": null,
    "success": true,
    "output": {
        "total": 1,
        "page_no": 1,
        "page_size": 20,
        "permissions": [
            {
                "model": "qwen-plus",
                "name": "通义千问-Plus",
                "permissions": {
                    "inference": true,
                    "fine_tune": false,
                    "deploy": false
                }
            }
        ]
    },
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

Códigos de error

Si la llamada falla, se devuelve un mensaje de error. Para obtener más información sobre códigos de error y soluciones, consulte Mensajes de error.