Skip to main content

Actualizar permisos de modelos

Llame al endpoint POST /api/v1/models/permissions para actualizar la autorización de modelos (inferencia / ajuste fino / despliegue) en un espacio de trabajo específico. Se admiten tanto la autorización por modelo como el modo "autorizar todo".

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: POST
  • 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 del cuerpo de la solicitud.

Parámetro

Tipo

Obligatorio

Descripción

models

Array[Object]

Condicionalmente requerido

Lista de elementos de autorización por modelo. Puede estar vacía cuando access_all_entities es OPEN/CLOSE; es obligatoria cuando es KEEP o no se especifica, en cuyo caso el número de elementos debe ser de 1 a 20. Ejemplo: [{"model":"qwen-plus","inference":true}]

models[].model

String

Sí

El ID del modelo. No puede estar vacío. Ejemplos: qwen-plus, qwen-max.

models[].inference

Boolean

No

Permiso de llamada al modelo. true = conceder permiso de inferencia, false = revocar, no especificado = mantener sin cambios. Valor predeterminado: null (sin cambios).

models[].finetune

Boolean

No

Permiso de entrenamiento del modelo. true = conceder permiso de ajuste fino, false = revocar, no especificado = mantener sin cambios. Valor predeterminado: null (sin cambios).

models[].deploy

Boolean

No

Permiso de despliegue del modelo. true = conceder permiso de despliegue, false = revocar, no especificado = mantener sin cambios. Valor predeterminado: null (sin cambios).

access_all_entities

String

No

Interruptor de autorización global. Valores válidos:

  • OPEN: Autorizar todos los modelos de inferencia en el espacio de trabajo actual con un solo clic (incluidos los modelos añadidos posteriormente).

  • CLOSE: Cancelar la autorización global y borrar las autorizaciones de inferencia históricas.

  • KEEP: Mantener el comportamiento original de autorización por modelo (predeterminado).

Cuando se pasa OPEN/CLOSE, models puede omitirse. Valor predeterminado: KEEP. Ejemplo: OPEN

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

Object

Datos comerciales. null para este endpoint.

Solicitudes de ejemplo

Ejemplo 1: Autorización por modelo 
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": "qwen-max", "inference": true}
        ]
    }'
Ejemplo 2: Autorizar todo 
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"}'

Respuesta de ejemplo

Ejemplo de éxito 
{
    "code": null,
    "message": null,
    "success": true,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}
Ejemplo de fallo 
{
    "code": "InvalidParameter",
    "message": "Model qwen-xxx is not authorized for Inference",
    "success": false,
    "output": null,
    "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.