GetBillingTrend

リクエスト構文

GET /modelstudio/billing/trend HTTP/1.1

リクエストパラメーター

名前	タイプ	必須	説明	例
granularity	string	はい	クエリの粒度。このフィールドは必須です。有効な値： MONTH：月次 DAY：日次	DAY
timePeriod	object	はい	開始時刻と終了時刻を含むクエリ時間範囲。このフィールドは必須です。
timePeriod.start	string	はい	YYYY-MM-DD形式の開始時刻。	2026-08-01
timePeriod.end	string	はい	YYYY-MM-DD形式の終了時刻。	2026-08-31
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。	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形式

{
  "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"
          }
        ]
      }
    ]
  }
}

​リクエスト構文

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

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

​例

リクエスト構文

リクエストパラメーター

レスポンスパラメーター

例