Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Anailísí Úsáide

Ceacht 9 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Tuig do Thomhaltas API
  2. Eireaball Anailíse
  3. Paraiméadair Iarratais
  4. Samplaí Praicticiúla
  5. Príomhphointí

Tuig do Thomhaltas API

Painéal úsáide sa chonsól xAI 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ú.

7
Aonaid Ama
9
Comhiomlánuithe
POST
Modh HTTP
groupBy
Briseadh síos de réir Samhaltaithe

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}/usage gach 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/Paris le haghaidh tuairiscí atá ailínithe le d’uair oibre