Anailísí Úsáide
Ar an leathanach seo
Tuig do Thomhaltas API
Inseoidh sonrasc duit cé mhéad a chaith tú; insíonn an t-eireaball seo duit cén fáth. Sin an difríocht idir breathnú agus gníomhú: briseann an tomhaltas síos de réir samhaltaithe, de réir tréimhse, agus ag an ngránúlacht a roghnaíonn tú, rud a ligeann duit buaic a nascadh le samhaltú ar leith ag am ar leith.
Tá a chomhréir níos saibhre ná an chuid eile den API Bainistíochta—trí bhloc paraiméadar le comhcheangal—ach tagann sé anuas ar thrí cheist: thar cén tréimhse, ag cén gránúlacht ama, agus cén tomhas. Clúdaíonn an ceacht seo iad san ord sin. Ligeann sé duit tomhaltas a anailísiú de réir samhaltaithe, de réir tréimhse, agus le gránúlachtaí ama éagsúla—sonraí riachtanacha chun costais a optamú agus d’infreastruchtúr a mhéadú.
Eireaball Anailíse
Tarlaíonn anailís úsáide trí iarratas POST:
POST /v1/billing/teams/{teamId}/usage
Struchtúr an Iarratais
{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-03-01 00:00:00",
"endTime": "2026-04-01 00:00:00",
"timezone": "UTC"
},
"timeUnit": "DAY",
"values": [
{"name": "tokens", "aggregation": "SUM"}
],
"groupBy": ["model"]
}
}
Iarraíonn an t-iarratas seo suim na dtócan a tomhailteadh in aghaidh an lae, briste síos de réir samhaltaithe, do mhí Mhárta 2026 in UTC. Bain úsáid as mar theimpléad: sa chleachtas, ní athróidh tú ach trí rud ó thuairisc go tuairisc—na tréimhse, an t-aonad ama, agus an mheadrach—faoi mar a fhanann an chuid eile den struchtúr mar an gcéanna.
Paraiméadair Iarratais
timeRange
Sainíonn sé an tréimhse anailíse:
- startTime : tús na tréimhse (formáid
YYYY-MM-DD HH:MM:SS) - endTime : deireadh na tréimhse (an fhoirmáid chéanna)
- timezone : an crios ama chun dátaí a léirmhíniú (m.sh.
UTC,Europe/Paris)
timeUnit
Gránúlacht ama na dtorthaí. Seo iad na roghanna atá ar fáil:
- MONTH : comhiomlánú míosúil
- CALENDAR_WEEK : comhiomlánú seachtaine féilire
- DAY : comhiomlánú laethúil
- HOUR : comhiomlánú uair an chloig
- QUARTER_HOUR : comhiomlánú ceathrú uair an chloig
- MINUTE : comhiomlánú nóiméid
- SECOND : comhiomlánú soicind
Roghnaigh an ghránúlacht bunaithe ar fhad an fheiniméin atá tú ag lorg, ní ar fhad na tréimhse atá á hanailísiú. Léitear tuairisc mhíosúil go maith in DAY; imíonn buaic deich nóiméad go hiomlán ag an scála sin agus ní fheictear í ach in QUARTER_HOUR. Tá costas ag baint le dul ró-íseal freisin—fásann toirt na bpointí a thugtar ar ais go tapa, agus mar sin déanann an torann.
values
Athraíonn an rogha feidhme comhiomlánaithe an cheist a chuirtear, agus is anseo a thuilleann céatadáin d’aird. Tugann AVG ar mhoill mheánach suaimhneach nach mbíonn ag duine ar bith i ndáiríre; tugann P99 an t-am feithimh a d’fhulaing do chuid úsáideoirí is mí-ádhúla—iadsan a dhéanann gearán. Maidir le costas, úsáid SUM; maidir le feidhmíocht, úsáid céatadán.
"values": [
{"name": "tokens", "aggregation": "SUM"},
{"name": "tokens", "aggregation": "AVG"},
{"name": "latency", "aggregation": "P99"}
]
Feidhmeanna comhiomlánaithe atá ar fáil:
- SUM : suim iomlán
- AVG : meán
- MIN : luach íosta
- MAX : luach uasta
- P50 : meánach (an 50ú céatadán)
- P90 : an 90ú céatadán
- P99 : an 99ú céatadán
- COUNT : líon na dtarluithe
- COUNT_DISTINCT : líon na luachanna ar leith
groupBy
Brisann sé síos torthaí de réir toise. Faoi láthair, tá grúpáil de réir model ar fáil, rud a ligeann duit tomhaltas ar leith a fheiceáil do gach samhaltú (grok-4.20-0309-reasoning, grok-4.3, srl.).
Samplaí Praicticiúla
Tomhaltas Laethúil don Mhí Reatha
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-04-01 00:00:00",
"endTime": "2026-05-01 00:00:00",
"timezone": "Europe/Paris"
},
"timeUnit": "DAY",
"values": [{"name": "tokens", "aggregation": "SUM"}],
"groupBy": ["model"]
}
}'
Líon na nIarratas in aghaidh na hUaire
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-04-03 00:00:00",
"endTime": "2026-04-04 00:00:00",
"timezone": "Europe/Paris"
},
"timeUnit": "HOUR",
"values": [{"name": "requests", "aggregation": "COUNT"}],
"groupBy": ["model"]
}
}'
Moill P99 de réir Samhaltaithe
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-04-01 00:00:00",
"endTime": "2026-04-04 00:00:00",
"timezone": "UTC"
},
"timeUnit": "DAY",
"values": [
{"name": "latency", "aggregation": "P99"},
{"name": "latency", "aggregation": "AVG"}
],
"groupBy": ["model"]
}
}'
Príomhphointí
- Lárnúnaíonn an t-eireaball
POST /v1/billing/teams/{teamId}/usagegach anailís - 7 ngránúlacht ama ar fáil, ó SECOND go MONTH
- 9 bhfeidhm chomhiomlánaithe: SUM, AVG, MIN, MAX, P50, P90, P99, COUNT, COUNT_DISTINCT
- Briseann an paraiméadar
groupBy: ["model"]síos torthaí de réir samhaltaithe - Úsáid an crios ama
Europe/Parisle haghaidh tuairiscí atá ailínithe le d’uair oibre