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

ACLanna agus Prionsabal na Príobháideachta Is Lú

Ceacht 8 as 12 Nuashonraithe 28 Iúil 2026 Ardleibhéal
Ar an leathanach seo
  1. Prionsabal na Príobháideachta Is Lú Curtha i bhFeidhm ar APIanna
  2. Córas ACL xAI
  3. Teorainneacha Ráta: Sraith Slándála Breise
  4. Straitéis Eochrach in aghaidh an Timpeallachta
  5. Ceadanna a Fhíorú agus a Iniúchadh
  6. Príomhphointí

Prionsabal na Príobháideachta Is Lú Curtha i bhFeidhm ar APIanna

Is ceann de na coincheapa is sine sa chibearshlándáil é prionsabal na príobháideachta is lú: ní mór gan rochtain a thabhairt do gach comhpháirt de chóras ach ar na hacmhainní atá riachtanach go docht dá oibriú. Tá an smaoineamh intuigthe nuair a thugann tú ar ais é sa domhan fisiceach—ní thugann tú an eochair mháistir don fhoirgneamh don duine atá ag cur uisce ar phlandaí an lóba. Nuair a chuirtear i bhfeidhm é ar eochracha API xAI, ciallaíonn sé seo go gcaithfear gach eochair a theorannú do na críochphointí agus na samhlacha amháin a theastaíonn ón bhfeidhmchlár a iompraíonn í. Má sceitheann an eochair seo riamh, faigheann an t-ionsaitheoir a ceadanna: déanann eochair atá teoranta do chomhrá le samhl amháin damáiste i bhfad níos lú ná eochair a osclaíonn an catalóg iomlán.

Cuireann xAI an prionsabal seo i bhfeidhm trí chóras granúlach ACL (Liosta Rialaithe Rochtana), a mhínímid thíos.

Córas ACL xAI

Leanann ACLanna an formáid api-key:{type}:{value}. Tá dhá chineál a bhaineann leatsa ó lá go lá: déanann api-key:endpoint:{endpoint} teorannú ar na críochphointí inrochtana, agus déanann api-key:model:{model_id} teorannú ar na samhlacha inúsáidte. Tá wildchárta ann freisin, api-key:endpoint:*, a thugann rochtain ar gach críochphointe—áisiúil d’fhorbairt, toirmiscthe i dtáirgeadh, go díreach toisc go gcuireann sé as do shochair na príobháideachta is lú.

Seo iad na críochphointí is féidir leat a údarú go haonair: chat (críochnú comhrá, an ceann is coitianta i bhfad), embed (giniúint leabaithe), image (giniúint agus eagarthóireacht íomhá), models (comhairliúchán liosta samhlacha), tokenize (tokenú téacs), documents (bainistíocht doiciméad), agus sample (sampláil).

Feicimis conas a fhéachann sé seo i sampla den saol mór. Samhlaigh chatbot tacaíochta do chustaiméirí a úsáideann an tsamhail grok-4.3 amháin i mód comhrá. Seo mar a bheadh a eochair idéalach:

{
  "name": "support-chatbot-prod",
  "acls": [
    "api-key:endpoint:chat",
    "api-key:model:grok-4.3"
  ],
  "qps": 5,
  "qpm": 100,
  "tpm": 500000,
  "expireTime": "2026-12-31T23:59:59Z"
}

Léigh an chumraíocht seo mar chonradh: ní féidir leis an eochair rochtain a fháil ach ar an gcríochphointe comhrá—gan íomhánna, gan leabaithe, mar sin gan aon mhí-úsáid fhéideartha chun na críche sin. Ní féidir léi ach grok-4.3 a úsáid, rud a chuireann cosc ar ghlaonna tionóideacha (nó mailíseacha) chuig samhlacha níos costasaí. Tá sí teoranta do 5 iarratas in aghaidh an tsoicind agus 100 in aghaidh an nóiméid, agus rachaidh sí in éag ar dháta ar eolas. Má dhéanann forbróir ar an tionscadal iarracht riamh giniúint íomhá a chur leis gan é a rá le duine ar bith, diúltóidh an API: cuireann an srian teicniúil an cinneadh ailtireachta i bhfeidhm.

Teorainneacha Ráta: Sraith Slándála Breise

Freagraíonn ACLanna an cheist “cad”, freagraíonn teorainneacha ráta “cé mhéad”. Cuireann QPS (Iarratais in aghaidh an tSoicind) teorainn le hiarratais in aghaidh an tsoicind: is é seo do chosaint i gcoinne buaicphointí tionóideacha—an lúb éigríochta a tugadh isteach le hathstruchtúrú oíche Aoine, nó ionsaí DDoS ag preabadh d’fheidhmchlár. Déanann QPM (Iarratais in aghaidh an Nóiméid) maolú ar an trácht thar thréimhse níos faide agus gabhann sé mí-úsáid a d’fhanfadh faoi radarc an QPS. TPM (Tokenanna in aghaidh an Nóiméid), ar deireadh, cuireann teorainn le toirt na dtokenanna a úsáidtear: cosnaíonn sé i gcoinne iarratais aonair an-fhada—úsáideoir ag greamú doiciméad 200 leathanach isteach i do chatbot—a dhéanfadh do bhuiséad a ídiú laistigh de nóiméad gan líon na n-iarratas údaraithe a shárú riamh.

Straitéis Eochrach in aghaidh an Timpeallachta

Go praiticiúil, ní chumraíonn tú eochair amháin ach teaghlach eochracha, agus tá loighic dá cuid féin ag gach timpeallacht. I bhforbairt, casann tú loighic an táirgthe bun os cionn: rochtain leathan, teorainneacha docht.

{
  "name": "dev-team-alpha",
  "acls": ["api-key:endpoint:*", "api-key:model:*"],
  "qps": 2,
  "qpm": 30,
  "tpm": 100000,
  "expireTime": "2026-06-30T23:59:59Z"
}

Is féidir le forbróirí gach rud a iniúchadh, ach seachnaíonn teorainneacha ísle iontais billeála má théann tástáil mícheart. Sa timpeallacht stáitsithe, ar an láimh eile, déanann tú cóipeáil cruinn ar ACLanna an táirgthe (api-key:endpoint:chat, api-key:model:grok-4.3, QPS 5, QPM 100, TPM 500000): is é seo an t-aon bhealach chun fadhb ceadanna a bhrath suas an sruth—má dhéanann cód stáitsithe iarracht ar ghlaon a dhiúltóidh an táirgeadh, is fearr é a fháil amach anois ná sa chéad uair an chloig tar éis dul beo. Comhcheanglaíonn an eochair táirgthe, áfach, ceadanna dian an stáitsithe le teorainneacha atá méadaithe don trácht fíor (mar shampla QPS 20, QPM 600, TPM 2000000) agus éag sceidealta—"expireTime": "2027-03-31T23:59:59Z" ar eochair darbh ainm prod-chatbot-v2.

Ceadanna a Fhíorú agus a Iniúchadh

Chun a fheiceáil cad atá ceadaithe go díreach d’eochair ghníomhach a dhéanamh, déan ceist ar an API leis an eochair féin:

curl https://api.x.ai/v1/api-key \
  -H "Authorization: Bearer $XAI_API_KEY"

Liostaíonn an freagairt ACLanna éifeachtacha, na stádasanna api_key_blocked agus api_key_disabled, leagan mascáilte den eochair (redacted_api_key), agus an team_id. Déan nós de bheith ag comparáid na nACLanna seo go rialta le fíor-riachtanais an fheidhmchláir: bíonn claonadh ag ceadanna carnadh le himeacht ama, gan laghdú go spontáineach riamh. Ar thaobh na samhlacha, filleann an críochphointe GET /auth/teams/{teamId}/models an liosta samhlacha atá ar fáil do d’fhoireann lena bpraghsáil—faisnéis luachmhar chun ACLanna samhlacha ábhartha a shainiú agus samhlacha costasacha nach n-úsáideann tú a dhíbirt.

Chun an t-iomlán seo a dhaingniú, déan iniúchadh iomlán ar do chuid eochracha. Liostaigh eochracha gníomhacha do gach foireann, ansin déan ceist ar gach ceann acu: an bhfuil a ACLanna íosta, gan wildchártaí sa táirgeadh? An bhfuil a teorainneacha ráta réasúnach? An bhfuil a dáta éaga socraithe? An aithníonn a ainm an feidhmchlár agus an timpeallacht—“prod-chatbot-v2” insíonn sé scéal, ní insíonn “key-test-2” aon scéal? Scrios eochracha dílleachta agus déan doiciméadú ar an toradh: feidhmeoidh an doiciméad seo mar phointe tosaigh don chéad iniúchadh eile, agus feicfidh tú ar an gcéad amharc cad a d’imeacht ón mbunlíne idir an dá linn.

Príomhphointí

  • Ní mór ACLanna sriantacha a bheith ag gach eochair: na críochphointí agus na samhlacha riachtanacha amháin
  • Ná húsáid wildchárta * riamh sa táirgeadh
  • Comhcheangail ACLanna le teorainneacha ráta (QPS, QPM, TPM) atá oiriúnaithe don úsáid fhíor
  • Cruthaigh eochracha ar leith in aghaidh na timpeallachta (forbairt, stáitsiú, táirgeadh) agus in aghaidh an fheidhmchláir—stáitsiú leis na hACLanna céanna leis an táirgeadh
  • Déan iniúchadh go rialta ar cheadanna ar do chuid eochracha gníomhacha trí GET /v1/api-key