Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Informazzjoni dwar il-Fatturazzjoni

Lezzjoni 5 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Immaniġġja l-fatturazzjoni permezz tal-API
  2. Irrikupra l-informazzjoni tal-fatturazzjoni
  3. Aġġorna l-informazzjoni
  4. Irrikupra l-fatturi
  5. Loġika tal-fatturazzjoni ta’ xAI
  6. Ara l-addebiti kurrenti
  7. Punti Ewlenin

Immaniġġja l-fatturazzjoni permezz tal-API

It-taqsima tal-Fatturazzjoni tal-API tal-Ġestjoni tippermettilek tirrikupra u taġġorna l-informazzjoni tal-fatturazzjoni tiegħek, tiġbed il-fatturi, u tmonitorja n-nefqa—kollox b’mod programmatiku. L-ebda qbiż lura u ‘l quddiem għall-konsowl biex tiċċekkja l-istatus tal-ħlas.

GET
Irrikupra
POST
Aġġorna
4
Status tal-fatturi
Kull xahar
Ċiklu ta' fatturazzjoni

Irrikupra l-informazzjoni tal-fatturazzjoni

Id-dettalji tal-fatturazzjoni jidhru innoċenti sakemm il-kontabbiltà tirrifjuta fattura minħabba isem żbaljat jew numru tal-VAT nieqes. Il-verifika tagħhom permezz tal-API tieħu talba waħda u tevita żball li ma jistax jissewwa: kif jispjega n-nota hawn taħt, ma tistax terġa’ tiġġenera fattura maħruġa b’dettalji ġodda.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Ir-risposta fiha d-dettalji tal-fatturazzjoni rreġistrati: isem il-kumpanija, l-indirizz, il-pajjiż, u n-numru tal-VAT jekk applikabbli.

Aġġorna l-informazzjoni

Biex timmodifika l-informazzjoni tal-fatturazzjoni tiegħek:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "My Company SAS",
    "address": "15 Peace Street",
    "city": "Paris",
    "country": "FR",
    "vatNumber": "FR12345678901"
  }'

Nota importanti dwar il-fatturi eżistenti

L-informazzjoni tal-fatturazzjoni aġġornata tapplika biss għal fatturi futuri. Ma tistax retroattivament terġa’ tiġġenera fattura b’dettalji ġodda. Iverifika l-informazzjoni tiegħek qabel ma jintemm iċ-ċiklu ta’ fatturazzjoni biex tiżgura fatturi preċiżi.

Irrikupra l-fatturi

L-endpoint GET /v1/billing/teams/{teamId}/invoices jirritorna l-istorja tal-fatturi tiegħek:

# Fatturi għal xahar speċifiku
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Fatturi minn xahar partikolari 'l quddiem
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Parametri ta’ filtrar

  • billingCycle.year u billingCycle.month: irrikupra fatturi għal ċiklu speċifiku
  • since.year u since.month: irrikupra l-fatturi kollha minn xahar mogħti

Status tal-fatturi

Minn dawn l-erba’ status, wieħed biss jeħtieġ azzjoni immedjata. FAILED ifisser li l-ħlas ma għaddiex—karta skaduta, limitu milħuq, tilwima—u fattura mhux imħallsa eventwalment twassal għas-sospensjoni tas-servizz. Dan huwa l-istatus li għandek tmonitorja awtomatikament, kif muri fil-lezzjoni dwar il-metodi ta’ ħlas; tirrevedi t-tlieta l-oħra, iżda twissi dwar dan.

  • PENDING: il-fattura qed tiġi pproċessata; il-ħlas għadu ma ġiex addebitat
  • PAID: il-ħlas kien suċċess
  • FAILED: il-ħlas falla (karta skaduta, fondi insuffiċjenti, eċċ.)
  • WILL_NEVER_BE_CHARGED: il-fattura qatt ma se tiġi addebitata (kreditu, aġġustament)

Loġika tal-fatturazzjoni ta’ xAI

Il-fehim ta’ kif jinteraġixxu ż-żewġ modi jipprevjeni interpretazzjonijiet żbaljati tad-dashboard tiegħek. Il-krediti mħallsa minn qabel jintużaw l-ewwel; il-fatturazzjoni ta’ kull xahar tibda biss ladarba l-bilanċ jintemm. Bilanċ żero b’servizz attiv mhuwiex anomali: ifisser li issa qed tikkonsma fuq bażi postpaid, u l-fattura ta’ tmiem ix-xahar qed takkumula.

Krediti mħallsa minn qabel (Prepaid)

Il-krediti mixtrija jiġu addebitati immedjatament fil-ħin tax-xiri. Kull sejħa tal-API tikkonsma krediti bbażati fuq in-numru ta’ tokens ipproċessati. Il-krediti jintużaw l-ewwel.

Fatturazzjoni ta’ kull xahar (Postpaid)

Jekk il-krediti tiegħek jintemmu jew ma jkollokx, il-konsum jiġi fatturat fi tmiem ix-xahar. L-ispiża ta’ kull sejħa tal-API tiġi kkalkulata immedjatament, iżda l-addebitu jsir fi tmiem iċ-ċiklu.

Differenzi fil-għadd tat-tokens

Stenna diskrepanza bejn il-għadd lokali tiegħek u l-għadd tal-fatturazzjoni, u huwa aħjar li tkun taf dan qabel ma tonfoq nofs jum tfittxu. Il-fatturazzjoni hija awtoritattiva: ibbaża l-istimi tal-ispiża tiegħek fuq iċ-ċifri tal-API tal-analitika, qatt fuq għadd imwettaq b’tokenizer fuq in-naħa tal-klijent. Dan huwa normali: l-endpoints tal-inferenza jżidu tokens interni għall-ipproċessar (istruzzjonijiet tas-sistema, formatjar), li jiżdied ftit il-għadd fatturat meta mqabbel mat-test raw.

Ara l-addebiti kurrenti

Biex tara l-addebiti akkumulati qabel ma jintemm iċ-ċiklu:

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Din il-previżjoni hija l-uniku mod biex tkun taf l-ammont kurrenti qabel ma tinħareġ il-fattura. Iċċekkjata darba fil-ġimgħa, issir il-fatturazzjoni ta’ kull xahar xi ħaġa li tista’ timmaniġġja: tara d-devjazzjoni tal-ispiża f’nofs it-triq, meta jkun hemm ħin biex tiddirezzjona t-traffiku lejn mudell irħas jew tonqos limitu.

Punti Ewlenin

  • GET u POST fuq /v1/billing/teams/{teamId}/billing-info biex tirrikupra u timmodifika l-informazzjoni
  • Il-fatturi għandhom 4 status: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
  • Il-bidliet fil-fatturazzjoni mhumiex retroattivi fuq fatturi eżistenti
  • xAI tgħaqqad krediti mħallsa minn qabel (prijorità) u fatturazzjoni ta’ kull xahar
  • Il-previżjoni tal-addebiti (invoice/preview) tippermettilek tanticipa l-ispejjeż