Skip to main content

Listar permisos de modelos

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.

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.