查詢指定時間範圍內的帳單趨勢資訊，支援按天或按月彙總，並按維度分組和篩選。
請求語法
請求參數
名稱 | 類型 | 必填 | 描述 | 範例值 |
|---|---|---|---|---|
| granularity | string | 是 | 查詢粒度，不可為空。取值：
| DAY |
| timePeriod | object | 是 | 查詢時間範圍，包含開始和結束時間，不可為空。 | |
| timePeriod.start | string | 是 | 開始時間，格式為 YYYY-MM-DD。 | 2026-08-01 |
| timePeriod.end | string | 是 | 結束時間，格式為 YYYY-MM-DD。 | 2026-08-31 |
| groupBy | array<object> | 是 | 分組條件，必須且只能包含一個元素。支援的維度 Code 請參閱下方補充說明。 | |
| groupBy.code | string | 是 | 維度 Code。 | MAAS_TYPE |
| filter | object | 否 | 維度過濾條件。 | |
| filter.dimensions | array<object> | 否 | 篩選維度清單。 | |
| filter.dimensions.code | string | 否 | 維度 Code。 | BASE_MODEL |
| filter.dimensions.values | array<string> | 否 | 篩選值清單。 | ["qwen-max"] |
| filter.dimensions.selectType | string | 否 | 篩選類型。取值：
| IN |
| topNum | integer | 否 | 傳回分組數量，範圍為 1～20，預設 20。其餘分組合併為「其他」。 | 20 |
| zeroFilter | boolean | 否 | 是否過濾金額為 0 的分組，預設為 true。 | true |
| regionId | string | 否 | 地域 ID。 | cn-beijing |
| locale | string | 否 | 回傳語言，預設 en-US。取值：
| zh-CN |
groupBy[].code 和 filter.dimensions[].code 支援以下值，建議統一使用大寫：
維度 Code | 含義 | filter.dimensions[].values 可傳值 |
|---|---|---|
MAAS_TYPE | MaaS 業務類型 | inference（模型調用）、training（模型訓練）、model_units（模型單元）、capacity_reserved（容量預留） |
BASE_MODEL | 基礎模型 | 帳單資料中的基礎模型原始值，例如 qwen-plus |
API_KEY_ID | API Key ID | 帳單資料中的 API Key ID 原始值 |
WORKSPACE_ID | 業務空間 ID | 帳單資料中的 Workspace ID 原始值 |
FEE_TYPE | 費用類型 | billing（帳單費用）、subscription（訂閱購買費用） |
CHARGE_TYPE | 付費類型 | postpaid（後付費）、prepaid（預付費） |
BUSINESS_REGION | 業務地域 | cn-beijing、ap-southeast-1、cn-hongkong 等，取值以實際值為準 |
SERVICE_SITE | 服務站點 | asia-pacific-china、global、international 等，取值以實際值為準 |
ARTICLE_CODE | 商品 Code | sfm_inferenceglobal_public_intl 等，取值以實際值為準 |
filter.dimensions[].values 均可傳 DIMENSION_FILTER_NULL_VALUE，表示匹配欄位為 NULL 或空字串的資料。返回參數
名稱 | 類型 | 描述 | 範例值 |
|---|---|---|---|
| requestId | string | 請求 ID。 | 099A671E-FA21-5A36-8A73-918572DDEF53 |
| code | string | 請求結果代碼。 | 200 |
| message | string | 請求結果說明。 | null |
| success | boolean | 請求是否成功。 | true |
| data | object | 返回資料。 | |
| data.costTotals | object | 整個查詢時間範圍內的費用合計，包含 TopN 和「其他」。 | |
| data.costTotals.amount | string | 費用總金額 | 100 |
| data.costTotals.pretaxAmount | string | 不含稅金額 | 94.34 |
| data.costTotals.taxAmount | string | 稅費金額 | 5.66 |
| data.costTotals.currency | string | 金額幣別 | CNY |
| data.groupByTotal | array<object> | 週期內 TopN 分組及可選「其他」分組的費用合計 | |
| data.groupByTotal.key | string | 分組維度值 | qwen-plus |
| data.groupByTotal.name | string | 分組顯示名稱，受輸入參數 locale 影響 | qwen-plus |
| data.groupByTotal.amount | string | 目前分組的總金額 | 60 |
| data.groupByTotal.pretaxAmount | string | 目前分組的不含稅金額 | 56.60 |
| data.groupByTotal.taxAmount | string | 目前分組的稅費金額 | 3.40 |
| data.resultByTime | array<object> | 按時間升序排列的費用趨勢清單 | |
| data.resultByTime.period | string | 統計週期。DAY 傳回 yyyyMMdd，MONTH 傳回 yyyyMM。 | 20260801 |
| data.resultByTime.total | object | 目前週期的費用合計 | |
| data.resultByTime.total.amount | string | 目前週期的費用總金額 | 30 |
| data.resultByTime.total.pretaxAmount | string | 目前週期的不含稅金額 | 28.30 |
| data.resultByTime.total.taxAmount | string | 目前週期的稅費金額 | 1.70 |
| data.resultByTime.total.currency | string | 目前週期的金額幣種 | CNY |
| data.resultByTime.periodDetails | array<object> | 目前週期實際存在的費用分組 | |
| data.resultByTime.periodDetails.key | string | 分組維度值。TopN 以外的資料使用 DIMENSION_GROUP_OTHERS_VALUE。 | qwen-plus |
| data.resultByTime.periodDetails.name | string | 分組顯示名稱，受輸入參數 locale 影響。 | qwen-plus |
| data.resultByTime.periodDetails.amount | string | 目前週期內該分組的金額 | 20 |
| data.resultByTime.periodDetails.pretaxAmount | string | 目前週期內該分組的不含稅金額 | 18.87 |
| data.resultByTime.periodDetails.taxAmount | string | 目前週期內該分組的稅費金額 | 1.13 |
| data.resultByTime.periodDetails.percentage | string | 目前分組金額佔目前週期總金額的比例 | 0.6667 |
範例
正常回傳範例
JSON格式