OpenAI SDK skirta Grok
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d. pagal xAI Models puslapį: „grok-4.7“ (2026 m. rugsėjis) pakeitė „grok-4.5“ kaip rekomenduojamą modelį; pavyzdys, parašytas su „grok-4.5“, veikia ir su „grok-4.7“. Šaltiniai: Models · Release notes.
Patikslinta 2026 m. lapkričio 3 d. pagal xAI „Chat Completions“ nuorodą: užklausa nėra visiškai identiška „OpenAI“ versijai; parametrai
logprobsirtop_logprobs(ignoruojami nuo „grok-4.20“) beilogit_bias(nepalaikomas) papildo toliau išvardytus skirtumus. Šaltinis: xAI, Chat Completions.
Panaudok tai, ką jau žinai apie OpenAI
Jei jau dirbi su „OpenAI“ SDK „Python“ kalba, gali naudoti jį tokį patį norėdamas kviesti „Grok“ API. Tereikia nukreipti užklausas į xAI serverius pakeitus bazinį URL. Tai greičiausias būdas, jei jau turi parengtą kodą.
Diegimas
Jei „OpenAI“ SDK dar nėra įdiegtas tavo projekte:
pip install openai
Sukonfigūruok klientą xAI
Vienintelis skirtumas nuo įprasto „OpenAI“ naudojimo yra parametras base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Tai viskas. Nuo šiol visi „OpenAI“ SDK metodai veikia su „Grok“ modeliais.
Siųsk žinutę
Užklausa turi tą pačią struktūrą kaip ir „GPT“, išskyrus nepalaikomus parametrus (žr. žemiau):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What's the difference between REST and GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Galimi modeliai
Tiesiog pakeisk „OpenAI“ modelio pavadinimą į „Grok“ modelį:
grok-4.7: xAI rekomenduojamas modelis, universalus, palaiko vaizdų įvestį („grok-4.6“ ir „grok-4.5“ vis dar prieinami)grok-4.20-0309-reasoning: pažangus samprotavimasgrok-4.3: greiti ir nebrangūs atsakymai (1 mln. konteksto)
Perkelk esamą „OpenAI“ projektą
Norėdamas pritaikyti esamą projektą, turi du pasirinkimus.
1 variantas: Aplinkos kintamieji
Pakeisk kintamuosius neliesdamas kodo:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
„OpenAI“ SDK šiuos kintamuosius nuskaitys automatiškai. Tavo esamas kodas veiks, jei taip pat pakeisi modelio pavadinimą ir pašalinsi parametrus, kurių xAI nepalaiko.
2 variantas: Aiški konfigūracija
Parašyk inicijavimo funkciją, kuri perjungia tiekėjus:
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() # Pagal nutylėjimą – OpenAI
client = create_client("xai")
Šis būdas leidžia migracijos metu lengvai perjungti tiekėjus.
Svarbūs skirtumai
Nors API yra suderinamas, kai kurios elgsenos skiriasi:
- Parametrai
frequency_penaltyirpresence_penaltynepalaikomi samprotavimo modeliuose - Parametras
stopneprieinamas samprotavimo modeliuose logprobsirtop_logprobsyra tyloje ignoruojami „grok-4.20“ ir naujesnių modelių, ologit_biasnepalaikomas- Modelių pavadinimai, žinoma, skiriasi
- Kai kurios xAI funkcijos („X“ paieška, žiniatinklio paieška) nėra prieinamos per standartinį „OpenAI“ formatą
Kada rinktis šį būdą
Suderinamumo režimas labiausiai tinka tada, kai tavo esamas kodas yra svarbesnis už išskirtines funkcijas. Dažniausias atvejis – migracija: kodas, jau parašytas „OpenAI“, pereina prie „Grok“ pakeitus bazinį URL ir raktą: dvi eilutės, joks perrašymas. Grįžtamumas taip pat svarbus: kol laikaisi „OpenAI“ formato, tiekėjo keitimas lieka konfigūracijos klausimu, o tai vertinga lyginant modelius ar derantis dėl sąlygų. Tuomet – ekosistema: trečiųjų šalių įrankiai, sukurti aplink „OpenAI“ SDK, pavyzdžiui, „LangChain“ ir „LlamaIndex“, veikia iškart, o komandai, jau įvaldžiusiai šį SDK, nieko naujo mokytis nereikia. Kaina, kurią tenka mokėti, yra ta, kurią matei aukščiau: xAI specifinės funkcijos atitenka antram planui.
Svarbiausi punktai
- Pridėk
base_url="https://api.x.ai/v1"įOpenAI()konstruktorių - Pakeisk API raktą ir modelio pavadinimą
- Kintamieji
OPENAI_BASE_URLirOPENAI_API_KEYleidžia atlikti migraciją neliečiant kodo - Kai kurie parametrai (baudos, sustabdymas) nepalaikomi samprotavimo modeliuose