Alibaba Cloud Model Studio: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.