Alibaba Cloud Model Studio:Obtenir les statistiques des sièges et des crédits d'abonnement

Interroger les statistiques des sièges et des crédits d'abonnement, y compris la période d'abonnement, le nombre de sièges par type, les sièges attribués et les crédits restants.

Prérequis

Vous avez obtenu l'AccessKey d'un compte Alibaba Cloud ou d'un utilisateur RAM, et l'identité s'est vu accorder les autorisations RAM nécessaires pour appeler cette opération. Nous vous recommandons de définir l'AccessKey comme variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET plutôt que de le coder en dur.

Description de la requête

• Méthode HTTP : GET

• URL de la requête

  Région	Point de terminaison
  Singapour	GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/stats

• Authentification

  Cette opération est une opération OpenAPI Alibaba Cloud qui utilise des signatures basées sur AccessKey (l'algorithme ACS3-HMAC-SHA256). Le schéma Authorization: Bearer {API_KEY} n'est pas pris en charge. Une requête doit comporter les en-têtes communs x-acs-action: GetSubscriptionStats, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce et Authorization.

  Nous vous recommandons d'appeler cette opération avec un SDK Alibaba Cloud ou OpenAPI Explorer afin de ne pas avoir à calculer la signature vous-même.

Paramètres de la requête

Cette API n'a aucun paramètre de requête.

Paramètres de réponse

Paramètre	Type	Description
Success	boolean	Indique si l'appel API a réussi : true : succès false : échec
Code	string	Code d'état de la réponse.
Message	string	Message de réponse.
Data	object	Données métier.
SubscriptionStartTime	integer	Heure de début de l'abonnement, en millisecondes
SubscriptionEndTime	integer	Heure de fin de l'abonnement, en millisecondes
Items	Array[Object]	Liste des informations sur les sièges (groupées par specType)
	object	Données de la liste
SeatType	string	Type de siège (specType) standard - Standard seat pro - Pro seat max - Max seat
SeatRefreshTime	integer	Heure d'actualisation du cycle actuel, en millisecondes
TotalSeats	integer	Nombre total de sièges
AssignedSeats	integer	Nombre de sièges attribués
SeatCredits	nombre	Quota total de Credits des sièges
SeatRemainingCredits	nombre	Credits restants du cycle actuel

Exemple de requête

Cette opération utilise les signatures OpenAPI d'Alibaba Cloud. Dans l'exemple suivant, ${SIGNATURE} doit être calculé avec l'algorithme ACS3-HMAC-SHA256, et x-acs-date ainsi que x-acs-signature-nonce doivent être remplacés par des valeurs réelles.

curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/stats" \
    --header "x-acs-action: GetSubscriptionStats" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: ${SIGNATURE_NONCE}" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

Exemple de réponse

{
  "Success": true,
  "Data": {
    "SubscriptionStartTime": 1788328800000,
    "SubscriptionEndTime": 1790920800000,
    "Items": [
      {
        "SeatType": "standard",
        "SeatRefreshTime": 1790920800000,
        "TotalSeats": 2,
        "AssignedSeats": 1,
        "SeatCredits": 100,
        "SeatRemainingCredits": 40
      }
    ]
  }
}

Codes d'erreur

Si l'appel échoue, un message d'erreur est renvoyé. Pour plus de codes d'erreur et de solutions, consultez Codes d'erreur.