GetBillingOverview

リクエスト構文

GET /modelstudio/billing/overview HTTP/1.1

リクエストパラメーター

名前	タイプ	必須	説明	例
billMonth	string	はい	YYYY-MM形式の課金月。このフィールドは必須です。	2026-08
groupBy	array<object>	はい	グループ化条件のリストです。現在、正確に1つのグループ化ディメンションを指定する必要があります。サポートされているディメンションコードについては、以下の補足説明を参照してください。
groupBy.code	string	はい	ディメンションコード。	MAAS_TYPE
filter	object	いいえ	フィルター条件。
filter.dimensions	array<object>	いいえ	フィルターディメンションのリスト。
filter.dimensions.code	string	いいえ	ディメンションコード。	BASE_MODEL
filter.dimensions.values	array<string>	いいえ	フィルター値のリスト。	["qwen-max"]
filter.dimensions.selectType	string	いいえ	フィルタータイプ。有効な値： IN NOT	IN
topNum	integer	いいえ	返されるグループの数。有効範囲：1～20。デフォルト値：20。	20
zeroFilter	boolean	いいえ	金額がゼロのグループを除外するかどうか。デフォルト値：true。	true
regionId	string	いいえ	リージョンID。	cn-beijing
locale	string	いいえ	レスポンス言語。デフォルト値：en-US。有効な値： en-US：英語 zh-CN：中国語	zh-CN

補足説明 groupBy[].codeおよびfilter.dimensions[].codeには以下の値がサポートされています。一貫して大文字を使用することを推奨します：

ディメンションコード	説明	有効な filter.dimensions[].values
MAAS_TYPE	MaaSビジネスタイプ	inference（モデル推論）、training（モデルトレーニング）、model_units（モデルユニット）、capacity_reserved（予約済みキャパシティ）
BASE_MODEL	ベースモデル	課金データからの元のベースモデル値（例：qwen-plus）
API_KEY_ID	APIキーID	課金データからの元のAPIキーID値
WORKSPACE_ID	ワークスペースID	課金データからの元のワークスペース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	プロダクトコード	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	グループディメンション値。Null値の場合はDIMENSION_FILTER_NULL_VALUEが返されます。	inference
data.groups.name	string	グループ表示名。localeパラメータの影響を受けます。Null値は「-」として表示されます。	モデル推論
data.groups.articleCodes	array<string>	このグループに関連するプロダクトコードのリスト。
data.groups.amount	string	このグループの金額。	3000
data.groups.percentage	string	グループ金額のTopN合計金額に対する比率。	0.10

例

成功レスポンスの例 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"
      }
    ]
  }
}

​リクエスト構文

​リクエストパラメーター

​レスポンスパラメーター

​例

リクエスト構文

リクエストパラメーター

レスポンスパラメーター

例