An SDK OpenAI do Grok
Ar an leathanach seo
Nuashonraithe an 3 Samhain 2026, bunaithe ar leathanach Múnlaí xAI: tháinig grok-4.7 (Meán Fómhair 2026) in ionad grok-4.5 mar an múnla molta; oibríonn an sampla, a scríobhadh le grok-4.5, le grok-4.7 freisin. Foinse: Múnlaí · Nótaí scaoilte.
Soiléirithe an 3 Samhain 2026, bunaithe ar thagairt Críochnuithe Comhrá xAI: níl an glao go hiomlán mar an gcéanna le ceann OpenAI; cuireann
logprobsagustop_logprobs(neamhaird orthu ógrok-4.20ar aghaidh) aguslogit_bias(gan tacaíocht) le difríochtaí atá liostaithe thíos. Foinse: xAI, Críochnuithe Comhrá.
Bain úsáid as an eolas atá agat cheana ar OpenAI
Má oibríonn tú cheana leis an SDK OpenAI i bPython, is féidir leat é a úsáid mar atá chun glaoch ar an API Grok. Níl le déanamh agat ach iarratais a athsheoladh chuig freastalaithe xAI tríd an mbun-URL a athrú. Is é seo an cur chuige is tapúla má tá cód ann cheana féin.
Suiteáil
Mura bhfuil an SDK OpenAI suiteáilte i do thionscadal fós:
pip install openai
Cumraigh an cliant do xAI
Níl aon difríocht idir é seo agus gnáthúsáid OpenAI ach an paraiméadar base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Sin é. Ón bpointe seo amach, oibríonn gach modh san SDK OpenAI le múnlaí Grok.
Seol teachtaireacht
Tá an cruth céanna ar an nglao agus atá ar GPT, ach amháin maidir le paraiméadair nach dtacaítear leo (féach thíos):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "Is cúntóir teicniúil tú."},
{"role": "user", "content": "Cad é an difríocht idir REST agus GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Múnlaí atá ar fáil
Níl le déanamh agat ach ainm an mhúnla OpenAI a chur in ionad ainm múnla Grok:
grok-4.7: an múnla a mholann xAI, ilghnéitheach, le hionchur íomhá (tágrok-4.6agusgrok-4.5ar fáil fós)grok-4.20-0309-reasoning: réasúnaíocht chun cinngrok-4.3: freagraí tapa, saor (comhthéacs 1M)
Tionscadal OpenAI atá ann cheana a aistriú
Chun tionscadal atá ann cheana a oiriúnú, tá dhá rogha agat.
Rogha 1: Athróga timpeallachta
Athraigh do chuid athróg gan do chód a shuathadh:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
Léann an SDK OpenAI na hathróga seo go huathoibríoch. Oibreoidh do chód atá ann cheana má athraíonn tú ainm an mhúnla freisin agus má bhaineann tú na paraiméadair nach dtacaíonn xAI leo.
Rogha 2: Cumraíocht shainráite
Scríobh feidhm tosaigh a aistríonn idir soláthraithe:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # OpenAI mar réamhshocrú
client = create_client("xai")
Ligeann an cur chuige seo duit aistriú go héasca idir soláthraithe le linn na himirce.
Difríochtaí le bheith ar an eolas fúthu
Cé go bhfuil an API comhoiriúnach, tá difríocht i roinnt iompraíochtaí:
- Níl tacaíocht do na paraiméadair
frequency_penaltyaguspresence_penaltyar mhúnlaí réasúnaíochta - Níl an paraiméadar
stopar fáil ar mhúnlaí réasúnaíochta - Déanann múnlaí
grok-4.20agus níos nuaí neamhaird arlogprobsagustop_logprobsgo ciúin, agus níl tacaíocht dologit_bias - Tá ainmneacha na múnlaí difriúil, ar ndóigh
- Níl roinnt gnéithe xAI (cuardach X, cuardach gréasáin) ar fáil tríd an bhformáid chaighdeánach OpenAI
Cathin an cur chuige seo a roghnú
Is é an mód comhoiriúnachta is mó ciall nuair a bhíonn níos mó tábhachta le do chód atá ann cheana ná le gnéithe eisiacha. Is é an cás is coitianta ná imirce: aistríonn cód a scríobhadh cheana do OpenAI go Grok tríd an mbun-URL agus an eochair a athrú: dhá líne, gan athscríobh. Tá inbhéartacht tábhachtach freisin: fad a fhanann tú ar an bhformáid OpenAI, is ábhar cumraíochta é soláthraithe a athrú, rud atá luachmhar chun múnlaí a chur i gcomparáid nó chun idirbheartaíocht a dhéanamh. Ansin tá an éiceachóras: oibríonn uirlisí tríú páirtí a tógadh timpeall an SDK OpenAI, mar shampla LangChain agus LlamaIndex, láithreach, agus níl aon rud nua le foghlaim ag foireann a bhfuil eolas cheana acu ar an SDK. Is é an praghas atá le híoc ná an ceann a chonaic tú thuas: téann gnéithe atá sonrach do xAI i dtábhacht níos lú.
Príomhphointí
- Cuir
base_url="https://api.x.ai/v1"leis an gconstruchtóirOpenAI() - Cuir an eochair API agus ainm an mhúnla in ionad na seancheann
- Ligeann na hathróga
OPENAI_BASE_URLagusOPENAI_API_KEYduit imirce a dhéanamh gan do chód a shuathadh - Níl tacaíocht do roinnt paraiméadar (pionóis, stop) ar mhúnlaí réasúnaíochta