查詢指定月份的帳單總覽資訊，支援按維度分組聚合與篩選。
請求語法
請求參數
名稱 | 類型 | 必填 | 描述 | 範例值 |
|---|---|---|---|---|
| billMonth | string | 是 | 帳單月份，格式為 YYYY-MM，不可為空。 | 2026-08 |
| 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。 | BB521414-5D38-5E66-AA66-963B2B4200E2 |
| code | string | 請求結果代碼。 | 200 |
| message | string | 請求結果說明。 | null |
| success | boolean | 請求是否成功。 | true |
| data | object | 帳單費用概覽資料。 | |
| data.currency | string | 金額幣別 | USD |
| data.totalAmount | string | 金額合計 | 31228.60 |
| data.pretaxAmount | string | 未含稅金額合計 | 28729.32 |
| data.taxAmount | string | 稅費合計 | 2499.28 |
| data.groups | array<object> | 按金額降序排列的 TopN 分組清單 | |
| data.groups.key | string | 分組維度值。空值返回 DIMENSION_FILTER_NULL_VALUE。 | inference |
| data.groups.name | string | 分組顯示名稱，受 locale 參數影響；空值顯示為 -。 | 模型呼叫 |
| data.groups.articleCodes | array<string> | 目前分組涉及的商品 Code 清單 | |
| data.groups.amount | string | 當前分組金額 | 3000 |
| data.groups.percentage | string | 分組金額佔 TopN 金額合計的比例 | 0.10 |
範例
正常回傳範例
JSON格式