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

Creidmheasanna Réamhíoctha

Ceacht 8 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Múnla réamhíoctha xAI
  2. Seiceáil do iarmhéid
  3. Creidmheasanna a cheannach (athluchtú)
  4. Straitéisí úsáide creidmheasa
  5. Monatóireacht iarmhéid
  6. Príomhphointí

Múnla réamhíoctha xAI

Ligeann creidmheasanna réamhíoctha duit iarmhéid a cheannach roimh ré, a úsáidtear de réir mar a dhéanann tú glaonna API. Is é an múnla seo an ceann is oiriúnaí chun caiteachas a rialú: ní chaiteann tú ach an méid a cheannaigh tú, gan aon iontais ag deireadh na míosa. Úsáidtear creidmheasanna sula mbíonn billeáil mhíosúil i gceist.

Seiceáil do iarmhéid

Casann an réamhíocaíocht an gaol riosca bun os cionn i gcomparáid le billeáil mhíosúil. Le híocaíocht iartheachtach, faigheann tú amach an méid ag an deireadh; le réamhíocaíocht, socraítear an teorainn roimh ré agus is é an scéal is measa ná go gcuirfear stad ar an tseirbhís—míshábháilte, ach teoranta. Do fhoireann atá ag iniúchadh an API nó do thionscadal le buiséad seasta, is é seo an comhréiteach ceart.

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

Tá an méid seo a leanas sa fhreagra:

  • An t-iarmhéid reatha i ndollairí
  • An stair athluchtaithe le dátaí agus méideanna
  • An stair úsáide de réir tréimhse

Creidmheasanna a cheannach (athluchtú)

Chun do iarmhéid creidmheasa a athluchtú:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00
  }'

Pointí tábhachtacha faoi chreidmheasanna

Tá tionchar praiticiúil ag na ceithre phointe thíos ar an gcaoi a ndéanann tú uathoibriú. Go háirithe an dara ceann: níl creidmheasanna in-aisíoctha. Leis sin amháin, cuirtear an straitéis chun ceannach mór amháin a dhéanamh “chun a bheith sábháilte” as an áireamh; is fearr athluchtuithe beaga minice, fiú má dhéanann tú iad a uathoibriú, ná caipiteal a bheith ceangailte i dtionscadal a d’fhéadfadh treo a athrú.

  • Gearrtar creidmheasanna láithreach ag an am ceannaigh ar do mhodh íocaíochta réamhshocraithe
  • Níl creidmheasanna réamhíoctha in-aisíoctha (mura bhfuil sé éigeantach go dlíthiúil i do dhlínse)
  • Úsáidtear creidmheasanna ar dtús sula mbíonn billeáil mhíosúil iartheachtach i gceist
  • Níl aon dáta éaga liostaithe do chreidmheasanna—fanann siad ar fáil go dtí go n-úsáidtear iad

Sreabhadh billeála le creidmheasanna

Is fiú an t-ord ídithe a bheith ar eolas agat sula ndéanann tú aon chumrú, mar cinneann sé cad a thaispeánann gach ceann de do dheascanna rialaithe. Téann creidmheasanna ar dtús, agus glacann an billeáil mhíosúil seilbh ina dhiaidh sin: i bhfocail eile, má tá iarmhéid réamhíoctha ag fanacht ag nialas agus gach rud ag obair, ciallaíonn sé sin gur athraigh tú go híocaíocht iartheachtach cheana féin gan a bheith ar an eolas agat.

  1. Creidmheasanna réamhíoctha ar fáil: baintear comharthaíocht (tokens) den iarmhéid réamhíoctha
  2. Creidmheasanna ídithe: aistríonn an t-ídite go billeáil mhíosúil (iartheachtach)
  3. Teorainn chaiteachais sroichte: diúltaítear d’iarratais

Straitéisí úsáide creidmheasa

Buiséad míosúil seasta

Is é seo an straitéis bhuiséid chrua: gan billeáil mhíosúil cumasaithe, stopann ídiú na gcreidmheasanna na glaonna in ionad fiachas a ghiniúint. Glac leis an gcomhréiteach—bristear an tseirbhís, agus is fearr gur rogha shainráite é seo ná teacht air oíche Aoine. Comhcheangail é leis an alart iarmhéid íseal a thuairiscítear níos déanaí.

import requests
from datetime import datetime

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Seiceáil iarmhéid
balance_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
balance = balance_resp.json().get("balance", 0)

# Athluchtú má tá an t-iarmhéid íseal
MONTHLY_BUDGET = 200.00
RECHARGE_THRESHOLD = 50.00

if balance < RECHARGE_THRESHOLD:
    top_up_amount = MONTHLY_BUDGET - balance
    requests.post(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/top-up",
        headers={
            "Authorization": f"Bearer {MGMT_KEY}",
            "Content-Type": "application/json"
        },
        json={"amount": top_up_amount}
    )
    print(f"Recharged ${top_up_amount:.2f}")

Soláthar tionscadail

Tá buntáiste ag baint le soláthar tionscadail seachas cuntasaíocht: éiríonn an t-iarmhéid ina thomhas ar dhul chun cinn. Má úsáidtear leath na gcreidmheasanna agus nach bhfuil ach ceathrú den obair déanta, faigheann tú an t-eolas roimh an deireadh, nuair atá am fós ann chun cinneadh a dhéanamh an raon feidhme a laghdú nó aistriú go múnlaí eile.

# Buiséad tionscadail: $500 thar 3 mhí
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type": "application/json" \
  -d '{"amount": 500.00}'

Ansin déan monatóireacht ar an úsáid trí anailísíocht (an chéad cheacht eile) chun a chinntiú go n-urramaítear an buiséad.

Monatóireacht iarmhéid

Alart iarmhéid íseal

#!/bin/bash
BALANCE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('balance', 0))")

THRESHOLD=20.00
if (( $(echo "$BALANCE < $THRESHOLD" | bc -l) )); then
    echo "ALERT: low prepaid balance ($BALANCE $)"
    # Seol fógra
fi

Deasc rialaithe úsáide

Comhcheangail an t-iarmhéid réamhíoctha leis an réamhamharc ar mhuirir iartheachtacha chun léargas iomlán a fháil ar do chostais:

# Iarmhéid réamhíoctha
echo "=== Prepaid Credits ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Muirir iartheachtacha reatha
echo "=== Postpaid Charges ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

Príomhphointí

  • Filleann GET /v1/billing/teams/{teamId}/prepaid/balance an t-iarmhéid agus an stair
  • Ceannaíonn POST /v1/billing/teams/{teamId}/prepaid/top-up creidmheasanna (gearrtar orthu láithreach)
  • Níl creidmheasanna réamhíoctha in-aisíoctha
  • Úsáidtear creidmheasanna sula mbíonn billeáil mhíosúil i gceist
  • Déan uathoibriú ar athluchtuithe le tairseach íosta chun bristeacha a sheachaint
  • Comhcheangail creidmheasanna réamhíoctha agus teorainneacha caiteachais chun rialú iomlán ar chostais