Alibaba Cloud Model Studio:Update model permissions

Appelez l'endpoint POST /api/v1/models/permissions pour mettre à jour les autorisations de modèle (inférence, fine-tuning ou déploiement) dans un workspace spécifié. Les modes d'autorisation par modèle et « tout autoriser » sont pris en charge.

Prérequis

Créez une clé API et configurez-la comme variable d'environnement DASHSCOPE_API_KEY. Pour plus d'informations, consultez la rubrique Configurer une clé API dans les variables d'environnement.

Requête

• Méthode HTTP : POST

• URL de la requête

  Remplacez {WorkspaceId} par l'ID de votre workspace.

  Région	Endpoint
  Chine (Pékin)	https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/permissions

• Authentification

  Définissez Authorization: Bearer {API_KEY} dans l'en-tête de la requête.

Paramètres de la requête

Transmettez tous les paramètres via le corps de la requête.

Paramètre	Type	Obligatoire	Description
models	Array[Object]	Conditionnellement obligatoire	Liste des éléments d'autorisation par modèle. Peut être vide lorsque access_all_entities est défini sur OPEN ou CLOSE ; obligatoire lorsque ce paramètre est défini sur KEEP ou n'est pas spécifié. Dans ce cas, le nombre d'éléments doit être compris entre 1 et 20. Exemple : [{"model":"qwen-plus","inference":true}]
models[].model	String	Oui	ID du modèle. Ne peut pas être vide. Exemples : qwen-plus, qwen-max.
models[].inference	Boolean	Non	Autorisation d'appel du modèle. true = accorder l'autorisation d'inférence, false = révoquer, non spécifié = conserver l'état actuel. Valeur par défaut : null (aucune modification).
models[].finetune	Boolean	Non	Autorisation d'entraînement du modèle. true = accorder l'autorisation de fine-tuning, false = révoquer, non spécifié = conserver l'état actuel. Valeur par défaut : null (aucune modification).
models[].deploy	Boolean	Non	Autorisation de déploiement du modèle. true = accorder l'autorisation de déploiement, false = révoquer, non spécifié = conserver l'état actuel. Valeur par défaut : null (aucune modification).
access_all_entities	String	Non	Interrupteur d'autorisation globale. Valeurs valides : OPEN : Autoriser tous les modèles d'inférence du workspace actuel en un clic (y compris les modèles ajoutés ultérieurement). CLOSE : Annuler l'autorisation globale et effacer les autorisations d'inférence historiques. KEEP : Conserver le comportement d'autorisation par modèle d'origine (valeur par défaut). Lorsque OPEN ou CLOSE est transmis, le paramètre models peut être omis. Valeur par défaut : KEEP. Exemple : OPEN

Paramètres de la réponse

Paramètre	Type	Description
request_id	String	ID de la requête. Exemple : d5f5201f-ee7a-9e3d-8569-bc0eedec21f9
code	String	Code d'erreur. null en cas de succès.
message	String	Message d'erreur. null en cas de succès.
success	Boolean	Indique si l'appel a réussi. Exemple : true
output	Object	Données métier. null pour cet endpoint.

Exemples de requêtes

Exemple 1 : Autorisation par modèle

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}
        ]
    }'

Exemple 2 : Tout autoriser

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"}'

Exemple de réponse

Exemple de succès

{
    "code": null,
    "message": null,
    "success": true,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

Exemple d'échec

{
    "code": "InvalidParameter",
    "message": "Model qwen-xxx is not authorized for Inference",
    "success": false,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

Codes d'erreur

En cas d'échec de l'appel, un message d'erreur est renvoyé. Pour plus d'informations sur les codes d'erreur et les solutions, consultez la rubrique Messages d'erreur.