Lister les autorisations de modèle - Alibaba Cloud Model Studio

Appelez le point de terminaison GET /api/v1/models/permissions pour interroger la liste des modèles autorisables ou autorisés et leurs détails d'autorisation dans l'espace de travail actuel.

Prérequis

Une clé API a été créée et configurée comme variable d'environnement DASHSCOPE_API_KEY. Pour plus d'informations, consultez Configurer une clé API dans les variables d'environnement.

Requête

Méthode HTTP : GET
URL de la requête

Remplacez {WorkspaceId} par votre ID d'espace de travail.

Région
Point de terminaison
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.

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

Paramètres de la requête

Tous les paramètres sont transmis via la chaîne de requête.

Paramètre	Type	Obligatoire	Description
name	String	Non	Recherche floue par nom de modèle. Effectue une correspondance floue avec `name` et `model_id`. Exemple : `qwen`
model	String	Non	Correspondance exacte par ID de modèle. Effectue une correspondance exacte avec `model_id`. Exemple : `qwen-plus`
page_no	Integer	Non	Numéro de page, un entier positif commençant à 1. Valeur par défaut : `1`.
page_size	Integer	Non	Nombre d'entrées par page, allant de 1 à 200 (maximum 200). Valeur par défaut : `20`.
authorization_scope	String	Non	Filtre de portée d'autorisation. Valeurs valides : `AUTHORIZABLE` : Modèles autorisables (par défaut). `AUTHORIZED` : Modèles autorisés. Valeur par défaut : `AUTHORIZABLE`. Exemple : `AUTHORIZED`
action	String	Non	Dimension d'action d'autorisation. Valeurs valides : `INFERENCE` - inférence (actuellement la seule valeur prise en charge). Active la dimension de filtre uniquement lorsque `authorization_scope=AUTHORIZED`. Valeur par défaut : `INFERENCE`.

Paramètres de réponse

Paramètre	Type	Description
request_id	String	L'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.total	Number	Nombre total. Exemple : `5`
output.page_no	Number	Numéro de page. Exemple : `1`
output.page_size	Number	Nombre d'entrées par page. Exemple : `20`
output.permissions	Array[Object]	Liste des autorisations. Voir l'exemple de réponse.
output.model	String	L'ID du modèle. Exemple : `qwen-plus`
output.name	String	Nom d'affichage du modèle. Exemple : `通义千问-Plus`
output.permissions[].permissions	Object	Détails de l'autorisation. Exemple : `{"inference":true,"fine_tune":false,"deploy":false}`. Contient les champs suivants : `inference` (Booléen) : Indique si le modèle dispose de l'autorisation d'appel de modèle. Exemple : `true` `finetune` (Booléen) : Indique si le modèle dispose de l'autorisation d'entraînement de modèle. Exemple : `false` `deploy` (Booléen) : Indique si le modèle dispose de l'autorisation de déploiement de modèle. Exemple : `false`

Exemples de requêtes

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'

Exemple de réponse

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

Codes d'erreur

Si l'appel échoue, un message d'erreur est retourné. Pour plus d'informations sur les codes d'erreur et les solutions, consultez Messages d'erreur.