Meminta informasi ikhtisar penagihan untuk bulan tertentu, dengan dukungan pengelompokan berdasarkan dimensi dan pemfilteran.
Sintaks permintaan
Parameter permintaan
Nama | Tipe | Wajib | Deskripsi | Contoh |
|---|---|---|---|---|
| billMonth | string | Ya | Bulan penagihan dalam format YYYY-MM. Bidang ini wajib diisi. | 2026-08 |
| groupBy | array<object> | Ya | Daftar kondisi pengelompokan. Saat ini, tepat satu dimensi pengelompokan harus ditentukan. Lihat catatan tambahan di bawah ini untuk kode dimensi yang didukung. | |
| groupBy.code | string | Ya | Kode dimensi. | MAAS_TYPE |
| filter | object | Tidak | Kondisi filter. | |
| filter.dimensions | array<object> | Tidak | Daftar dimensi filter. | |
| filter.dimensions.code | string | Tidak | Kode dimensi. | BASE_MODEL |
| filter.dimensions.values | array<string> | Tidak | Daftar nilai filter. | ["qwen-max"] |
| filter.dimensions.selectType | string | Tidak | Jenis filter. Nilai yang valid:
| IN |
| topNum | integer | Tidak | Jumlah grup yang akan dikembalikan. Rentang yang valid: 1 hingga 20. Nilai default: 20. | 20 |
| zeroFilter | boolean | Tidak | Apakah akan memfilter grup dengan jumlah nol. Nilai default: true. | true |
| regionId | string | Tidak | ID Wilayah. | cn-beijing |
| locale | string | Tidak | Bahasa respons. Nilai default: en-US. Nilai yang valid:
| zh-CN |
groupBy[].code dan filter.dimensions[].code. Sebaiknya gunakan huruf besar secara konsisten:
Kode dimensi | Deskripsi | filter.dimensions[].values yang valid |
|---|---|---|
MAAS_TYPE | Jenis bisnis MaaS | inference (inferensi model), training (pelatihan model), model_units (unit model), capacity_reserved (kapasitas cadangan) |
BASE_MODEL | Model dasar | Nilai model dasar asli dari data penagihan, seperti qwen-plus |
API_KEY_ID | ID Kunci API | Nilai ID Kunci API asli dari data penagihan |
WORKSPACE_ID | ID Workspace | Nilai Workspace ID asli dari data penagihan |
FEE_TYPE | Jenis biaya | billing (biaya tagihan), subscription (biaya langganan) |
CHARGE_TYPE | Metode penagihan | postpaid (bayar sesuai pemakaian), prepaid (langganan) |
BUSINESS_REGION | Wilayah bisnis | cn-beijing, ap-southeast-1, cn-hongkong, dll. Nilai didasarkan pada data aktual |
SERVICE_SITE | Situs layanan | asia-pacific-china, global, international, dll. Nilai didasarkan pada data aktual |
ARTICLE_CODE | Kode artikel | sfm_inferenceglobal_public_intl, dll. Nilai didasarkan pada data aktual |
DIMENSION_FILTER_NULL_VALUE dalam filter.dimensions[].values untuk dimensi apa pun guna mencocokkan catatan di mana bidangnya adalah NULL atau string kosong.Parameter respons
Nama | Tipe | Deskripsi | Contoh |
|---|---|---|---|
| requestId | string | ID Permintaan. | BB521414-5D38-5E66-AA66-963B2B4200E2 |
| code | string | Kode respons. | 200 |
| message | string | Pesan respons. | null |
| success | boolean | Apakah permintaan berhasil. | true |
| data | object | Data ikhtisar penagihan. | |
| data.currency | string | Mata uang jumlah. | USD |
| data.totalAmount | string | Jumlah total. | 31228.60 |
| data.pretaxAmount | string | Jumlah total tidak termasuk pajak. | 28729.32 |
| data.taxAmount | string | Jumlah pajak total. | 2499.28 |
| data.groups | array<object> | Daftar grup TopN yang diurutkan berdasarkan jumlah secara menurun. | |
| data.groups.key | string | Nilai dimensi grup. Nilai Null mengembalikan DIMENSION_FILTER_NULL_VALUE. | inference |
| data.groups.name | string | Nama tampilan grup, dipengaruhi oleh parameter locale. Nilai Null ditampilkan sebagai -. | Inferensi Model |
| data.groups.articleCodes | array<string> | Daftar kode artikel yang terlibat dalam grup ini. | |
| data.groups.amount | string | Jumlah untuk grup ini. | 3000 |
| data.groups.percentage | string | Rasio jumlah grup terhadap jumlah total TopN. | 0.10 |
Contoh
Contoh respons berhasil
Format JSON