Meminta informasi tren penagihan untuk rentang waktu tertentu, dengan dukungan agregasi harian atau bulanan, pengelompokan berdasarkan dimensi, dan pemfilteran.
Sintaks permintaan
Parameter permintaan
Nama | Tipe | Wajib | Deskripsi | Contoh |
|---|---|---|---|---|
| granularity | string | Ya | Granularitas kueri. Bidang ini wajib diisi. Nilai yang valid:
| DAY |
| timePeriod | object | Ya | Rentang waktu kueri, termasuk waktu mulai dan akhir. Bidang ini wajib diisi. | |
| timePeriod.start | string | Ya | Waktu mulai dalam format YYYY-MM-DD. | 2026-08-01 |
| timePeriod.end | string | Ya | Waktu akhir dalam format YYYY-MM-DD. | 2026-08-31 |
| groupBy | array<object> | Ya | Kondisi pengelompokan. Tepat satu elemen 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 dimensi. | |
| 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. Grup yang tersisa digabungkan ke dalam "Other". | 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. | 099A671E-FA21-5A36-8A73-918572DDEF53 |
| code | string | Kode respons. | 200 |
| message | string | Pesan respons. | null |
| success | boolean | Apakah permintaan berhasil. | true |
| data | object | Data respons. | |
| data.costTotals | object | Biaya total untuk seluruh rentang waktu kueri, termasuk TopN dan "Other". | |
| data.costTotals.amount | string | Jumlah biaya total. | 100 |
| data.costTotals.pretaxAmount | string | Jumlah sebelum pajak. | 94.34 |
| data.costTotals.taxAmount | string | Jumlah pajak. | 5.66 |
| data.costTotals.currency | string | Mata uang jumlah. | CNY |
| data.groupByTotal | array<object> | Biaya total untuk grup TopN dan grup "Other" opsional dalam periode tersebut. | |
| data.groupByTotal.key | string | Nilai dimensi grup. | qwen-plus |
| data.groupByTotal.name | string | Nama tampilan grup, dipengaruhi oleh parameter locale. | qwen-plus |
| data.groupByTotal.amount | string | Jumlah total untuk grup ini. | 60 |
| data.groupByTotal.pretaxAmount | string | Jumlah sebelum pajak untuk grup ini. | 56.60 |
| data.groupByTotal.taxAmount | string | Jumlah pajak untuk grup ini. | 3.40 |
| data.resultByTime | array<object> | Daftar tren biaya yang diurutkan berdasarkan waktu secara menaik. | |
| data.resultByTime.period | string | Periode statistik. DAY mengembalikan yyyyMMdd, MONTH mengembalikan yyyyMM. | 20260801 |
| data.resultByTime.total | object | Biaya total untuk periode saat ini. | |
| data.resultByTime.total.amount | string | Jumlah biaya total untuk periode saat ini. | 30 |
| data.resultByTime.total.pretaxAmount | string | Jumlah sebelum pajak untuk periode saat ini. | 28.30 |
| data.resultByTime.total.taxAmount | string | Jumlah pajak untuk periode saat ini. | 1.70 |
| data.resultByTime.total.currency | string | Mata uang jumlah untuk periode saat ini. | CNY |
| data.resultByTime.periodDetails | array<object> | Grup biaya yang benar-benar ada dalam periode saat ini. | |
| data.resultByTime.periodDetails.key | string | Nilai dimensi grup. Data di luar TopN menggunakan DIMENSION_GROUP_OTHERS_VALUE. | qwen-plus |
| data.resultByTime.periodDetails.name | string | Nama tampilan grup, dipengaruhi oleh parameter locale. | qwen-plus |
| data.resultByTime.periodDetails.amount | string | Jumlah untuk grup ini dalam periode saat ini. | 20 |
| data.resultByTime.periodDetails.pretaxAmount | string | Jumlah sebelum pajak untuk grup ini dalam periode saat ini. | 18.87 |
| data.resultByTime.periodDetails.taxAmount | string | Jumlah pajak untuk grup ini dalam periode saat ini. | 1.13 |
| data.resultByTime.periodDetails.percentage | string | Rasio jumlah grup ini terhadap jumlah total periode saat ini. | 0.6667 |
Contoh
Contoh respons berhasil
Format JSON