Informazzjoni dwar il-Fatturazzjoni
F'din il-paġna
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.
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
GETuPOSTfuq/v1/billing/teams/{teamId}/billing-infobiex 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ż