GetBillingOverview - Model Studio - Alibaba Cloud_Model Studio - Alibaba Cloud Model Studio

Interroge les informations générales de facturation pour un mois spécifié, avec prise en charge du regroupement par dimensions et du filtrage.

Syntaxe de la requête

GET /modelstudio/billing/overview HTTP/1.1

Paramètres de la requête

Nom	Type	Obligatoire	Description	Exemple
billMonth	string	Oui	Mois de facturation au format AAAA-MM. Ce champ est obligatoire.	2026-08
groupBy	array<object>	Oui	Liste des conditions de regroupement. Actuellement, exactement une dimension de regroupement doit être spécifiée. Consultez les notes complémentaires ci-dessous pour les codes de dimension pris en charge.
groupBy.code	string	Oui	Code de dimension.	MAAS_TYPE
filter	object	Non	Conditions de filtrage.
filter.dimensions	array<object>	Non	Liste des dimensions de filtre.
filter.dimensions.code	string	Non	Code de dimension.	BASE_MODEL
filter.dimensions.values	array<string>	Non	Liste des valeurs de filtre.	["qwen-max"]
filter.dimensions.selectType	string	Non	Type de filtre. Valeurs valides : IN NOT	IN
topNum	integer	Non	Nombre de groupes à retourner. Plage valide : de 1 à 20. Valeur par défaut : 20.	20
zeroFilter	boolean	Non	Indique s'il faut filtrer les groupes dont le montant est nul. Valeur par défaut : true.	true
regionId	string	Non	ID de région.	cn-beijing
locale	string	Non	Langue de la réponse. Valeur par défaut : en-US. Valeurs valides : en-US : Anglais zh-CN : Chinois	zh-CN

Notes supplémentaires

Les valeurs suivantes sont prises en charge pour groupBy[].code et filter.dimensions[].code. Nous recommandons d'utiliser systématiquement des majuscules :

Code de dimension	Description	Valeurs valides pour filter.dimensions[].values
MAAS_TYPE	Type d'activité MaaS	inference (inférence de modèle), training (entraînement de modèle), model_units (unités de modèle), capacity_reserved (capacité réservée)
BASE_MODEL	Modèle de base	Valeurs de modèle de base d'origine issues des données de facturation, telles que qwen-plus
API_KEY_ID	ID de clé API	Valeurs originales d'ID de clé API provenant des données de facturation
WORKSPACE_ID	ID d'espace de travail	Valeurs d'ID d'espace de travail d'origine issues des données de facturation
FEE_TYPE	Type de frais	billing (frais de facturation), subscription (frais d'abonnement)
CHARGE_TYPE	Mode de facturation	postpaid (paiement à l'usage), prepaid (abonnement)
BUSINESS_REGION	Région commerciale	cn-beijing, ap-southeast-1, cn-hongkong, etc. Les valeurs sont basées sur les données réelles
SERVICE_SITE	Site de service	asia-pacific-china, global, international, etc. Les valeurs sont basées sur les données réelles
ARTICLE_CODE	Code d'article	sfm_inferenceglobal_public_intl, etc. Les valeurs sont basées sur les données réelles

RemarqueVous pouvez passer DIMENSION_FILTER_NULL_VALUE dans filter.dimensions[].values pour n'importe quelle dimension afin de faire correspondre les enregistrements où le champ est NULL ou une chaîne vide.

Paramètres de réponse

Nom	Type	Description	Exemple
requestId	string	ID de demande.	BB521414-5D38-5E66-AA66-963B2B4200E2
code	string	Code de réponse.	200
message	string	Message de réponse.	null
success	boolean	Indique si la requête a réussi.	true
data	object	Données de synthèse de facturation.
data.currency	string	Devise du montant.	USD
data.totalAmount	string	Montant total.	31228.60
data.pretaxAmount	string	Montant total hors taxes.	28729.32
data.taxAmount	string	Montant total des taxes.	2499.28
data.groups	array<object>	Liste des groupes TopN triés par montant en ordre décroissant.
data.groups.key	string	Valeur de dimension du groupe. Les valeurs Null retournent DIMENSION_FILTER_NULL_VALUE.	inference
data.groups.name	string	Nom d'affichage du groupe, influencé par le paramètre locale. Les valeurs Null sont affichées sous la forme -.	Inférence de modèle
data.groups.articleCodes	array<string>	Liste des codes d'article impliqués dans ce groupe.
data.groups.amount	string	Montant pour ce groupe.	3000
data.groups.percentage	string	Ratio du montant du groupe par rapport au montant total TopN.	0.10

Exemples

Exemple de réponse réussie

Format JSON

{
  "requestId": "BB521414-5D38-5E66-AA66-963B2B4200E2",
  "code": "200",
  "message": "null",
  "success": true,
  "data": {
    "currency": "USD",
    "totalAmount": "31228.60",
    "pretaxAmount": "28729.32",
    "taxAmount": "2499.28",
    "groups": [
      {
        "key": "inference",
        "name": "Model Inference",
        "articleCodes": [
          "sfm_inferenceglobal_public_intl"
        ],
        "amount": "3000",
        "percentage": "0.10"
      }
    ]
  }
}