OpenAI SDK Grokia varten
Tällä sivulla
Päivitetty 3. marraskuuta 2026 xAI:n Models-sivun perusteella: grok-4.7 (syyskuu 2026) korvasi grok-4.5:n suositeltuna mallina; esimerkki, joka on kirjoitettu grok-4.5:lle, toimii myös grok-4.7:n kanssa. Lähteet: Models · Release notes.
Selvennetty 3. marraskuuta 2026 xAI:n Chat Completions -viitteen perusteella: kutsu ei ole täysin identtinen OpenAI:n kanssa;
logprobsjatop_logprobs(jätetään huomiotta mallistagrok-4.20alkaen) sekälogit_bias(ei tuettu) lisäävät alla lueteltuihin eroihin. Lähde: xAI, Chat Completions.
Hyödynnä OpenAI-tuntemustasi
Jos käytät jo OpenAI SDK:ta Pythonissa, voit käyttää sitä sellaisenaan Grok API:n kutsumiseen. Ohjaa pyynnöt vain xAI:n palvelimille muuttamalla base URL -osoitetta. Tämä on nopein tapa, jos sinulla on olemassa olevaa koodia.
Asennus
Jos OpenAI SDK:ta ei ole vielä asennettu projektiisi:
pip install openai
Asiakkaan konfigurointi xAI:ta varten
Ainoa ero tavanomaiseen OpenAI-käyttöön on base_url-parametri:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Siinä kaikki. Tästä eteenpäin kaikki OpenAI SDK:n metodit toimivat Grok-mallien kanssa.
Viestin lähetys
Kutsu näyttää samalta kuin GPT:n kohdalla, lukuun ottamatta tukemattomia parametreja (katso alta):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "Olet tekninen avustaja."},
{"role": "user", "content": "Mikä on ero REST:n ja GraphQL:n välillä?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Käytettävissä olevat mallit
Korvaa OpenAI-mallin nimi Grok-mallilla:
grok-4.7: xAI:n suosittelema malli, monipuolinen, tukee kuvasyötettä (grok-4.6jagrok-4.5ovat edelleen saatavilla)grok-4.20-0309-reasoning: edistynyt päättelykykygrok-4.3: nopeat ja edulliset vastaukset (1M konteksti)
Olemassa olevan OpenAI-projektin siirtäminen
Olemassa olevan projektin mukauttamiseen sinulla on kaksi vaihtoehtoa.
Vaihtoehto 1: Ympäristömuuttujat
Muuta muuttujiasi koskematta koodiin:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
OpenAI SDK lukee nämä muuttujat automaattisesti. Olemassa oleva koodisi toimii, jos muutat myös mallin nimen ja poistat parametrit, joita xAI ei tue.
Vaihtoehto 2: Eksplisiittinen konfigurointi
Kirjoita alustusfunktio, joka vaihtaa tarjoajien välillä:
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 oletuksena
client = create_client("xai")
Tämä lähestymistapa mahdollistaa helpon vaihtamisen tarjoajien välillä siirtymävaiheen aikana.
Huomioitavat erot
Vaikka API on yhteensopiva, jotkin toimintatavat eroavat toisistaan:
- Parametrit
frequency_penaltyjapresence_penaltyeivät ole tuettuja päättelymalleissa - Parametri
stopei ole käytettävissä päättelymalleissa logprobsjatop_logprobsjätetään hiljaisesti huomiotta malleissagrok-4.20ja uudemmissa, eikälogit_biasole tuettu- Mallien nimet ovat luonnollisesti erilaisia
- Jotkut xAI:n ominaisuudet (X-haku, verkkohaku) eivät ole käytettävissä standardin OpenAI-muodon kautta
Milloin valita tämä lähestymistapa
Yhteensopivuustila on järkevin silloin, kun olemassa oleva koodisi on tärkeämpää kuin eksklusiiviset ominaisuudet. Yleisin tapaus on migraatio: OpenAI:ta varten jo kirjoitettu koodi siirtyy Grokiin muuttamalla base URL -osoitetta ja avainta: kaksi riviä, ei uudelleenkirjoitusta. Palautettavuus on myös tärkeää: niin kauan kuin pysyt OpenAI-muodossa, tarjoajan vaihtaminen on vain konfiguraatiokysymys, mikä on arvokasta malleja vertaillessa tai neuvoteltaessa. Sitten on ekosysteemi: OpenAI SDK:n ympärille rakennetut kolmansien osapuolten työkalut, kuten LangChain ja LlamaIndex, toimivat välittömästi, ja tiimi, joka jo tuntee SDK:n, ei joudu opettelemaan mitään uutta. Hintana on se, mitä näit yllä: xAI:n omat ominaisuudet jäävät taka-alalle.
Keskeiset asiat
- Lisää
base_url="https://api.x.ai/v1"OpenAI()-konstruktoriin - Vaihda API-avain ja mallin nimi
- Muuttujat
OPENAI_BASE_URLjaOPENAI_API_KEYmahdollistavat siirtymisen koskematta koodiin - Jotkut parametrit (rangaistukset, stop) eivät ole tuettuja päättelymalleissa