Interroge les informations de tendance de facturation pour une plage de temps spécifiée, avec prise en charge de l'agrégation quotidienne ou mensuelle, du regroupement par dimensions et du filtrage.
Syntaxe de la requête
GET /modelstudio/billing/trend HTTP/1.1
Paramètres de la requête
Nom | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| granularity | string | Oui | Granularité de la requête. Ce champ est obligatoire. Valeurs valides :
| DAY |
| timePeriod | object | Oui | Plage de temps de la requête, incluant les heures de début et de fin. Ce champ est obligatoire. | |
| timePeriod.start | string | Oui | Heure de début au format AAAA-MM-JJ. | 2026-08-01 |
| timePeriod.end | string | Oui | Heure de fin au format AAAA-MM-JJ. | 2026-08-31 |
| groupBy | array<object> | Oui | Condition de regroupement. Exactement un élément doit être spécifié. 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 des dimensions. | |
| 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 |
| topNum | integer | Non | Nombre de groupes à retourner. Plage valide : de 1 à 20. Valeur par défaut : 20. Les groupes restants sont fusionnés dans « Other ». | 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 :
| 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. | 099A671E-FA21-5A36-8A73-918572DDEF53 |
| 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 réponse. | |
| data.costTotals | object | Coût total pour l'ensemble de la plage de temps de requête, y compris TopN et « Other ». | |
| data.costTotals.amount | string | Montant total des coûts. | 100 |
| data.costTotals.pretaxAmount | string | Montant hors taxes. | 94.34 |
| data.costTotals.taxAmount | string | Montant des taxes. | 5.66 |
| data.costTotals.currency | string | Devise du montant. | CNY |
| data.groupByTotal | array<object> | Coût total pour les groupes TopN et le groupe optionnel « Other » au sein de la période. | |
| data.groupByTotal.key | string | Valeur de dimension du groupe. | qwen-plus |
| data.groupByTotal.name | string | Nom d'affichage du groupe, influencé par le paramètre locale. | qwen-plus |
| data.groupByTotal.amount | string | Montant total pour ce groupe. | 60 |
| data.groupByTotal.pretaxAmount | string | Montant hors taxes pour ce groupe. | 56.60 |
| data.groupByTotal.taxAmount | string | Montant des taxes pour ce groupe. | 3.40 |
| data.resultByTime | array<object> | Liste des tendances de coûts triées par ordre chronologique croissant. | |
| data.resultByTime.period | string | Période statistique. DAY retourne yyyyMMdd, MONTH retourne yyyyMM. | 20260801 |
| data.resultByTime.total | object | Coût total pour la période en cours. | |
| data.resultByTime.total.amount | string | Montant total des coûts pour la période en cours. | 30 |
| data.resultByTime.total.pretaxAmount | string | Montant hors taxes pour la période en cours. | 28.30 |
| data.resultByTime.total.taxAmount | string | Montant des taxes pour la période en cours. | 1.70 |
| data.resultByTime.total.currency | string | Devise du montant pour la période en cours. | CNY |
| data.resultByTime.periodDetails | array<object> | Groupes de coûts qui existent réellement dans la période en cours. | |
| data.resultByTime.periodDetails.key | string | Valeur de dimension du groupe. Les données hors TopN utilisent DIMENSION_GROUP_OTHERS_VALUE. | qwen-plus |
| data.resultByTime.periodDetails.name | string | Nom d'affichage du groupe, influencé par le paramètre locale. | qwen-plus |
| data.resultByTime.periodDetails.amount | string | Montant pour ce groupe dans la période en cours. | 20 |
| data.resultByTime.periodDetails.pretaxAmount | string | Montant hors taxes pour ce groupe dans la période en cours. | 18.87 |
| data.resultByTime.periodDetails.taxAmount | string | Montant des taxes pour ce groupe dans la période en cours. | 1.13 |
| data.resultByTime.periodDetails.percentage | string | Ratio du montant de ce groupe par rapport au montant total de la période en cours. | 0.6667 |
Exemples
Exemple de réponse réussie
Format JSON
{
"requestId": "099A671E-FA21-5A36-8A73-918572DDEF53",
"code": "200",
"message": "null",
"success": true,
"data": {
"costTotals": {
"amount": "100",
"pretaxAmount": "94.34",
"taxAmount": "5.66",
"currency": "CNY"
},
"groupByTotal": [
{
"key": "qwen-plus",
"name": "qwen-plus",
"amount": "60",
"pretaxAmount": "56.60",
"taxAmount": "3.40"
}
],
"resultByTime": [
{
"period": "20260801",
"total": {
"amount": "30",
"pretaxAmount": "28.30",
"taxAmount": "1.70",
"currency": "CNY"
},
"periodDetails": [
{
"key": "qwen-plus",
"name": "qwen-plus",
"amount": "20",
"pretaxAmount": "18.87",
"taxAmount": "1.13",
"percentage": "0.6667"
}
]
}
]
}
}