OpenAI SDK priekš Grok
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, balstoties uz xAI Models lapu: grok-4.7 (2026. gada septembris) nomainīja grok-4.5 kā ieteicamo modeli; piemērs, kas rakstīts ar grok-4.5, darbojas arī ar grok-4.7. Avoti: Models · Release notes.
Precizēts 2026. gada 3. novembrī, balstoties uz xAI Chat Completions atsauces dokumentāciju: izsaukums nav stingri identisks OpenAI versijai;
logprobsuntop_logprobs(tiek ignorēti, sākot nogrok-4.20) unlogit_bias(netiek atbalstīts) papildina zemāk uzskaitītās atšķirības. Avots: xAI, Chat Completions.
Izmanto savas OpenAI zināšanas
Ja jau strādā ar OpenAI SDK valodā Python, vari to izmantot tāpat, lai izsauktu Grok API. Vienkārši novirzi pieprasījumus uz xAI serveriem, mainot bāzes URL. Tas ir ātrākais risinājums, ja tev jau ir esošs kods.
Instalācija
Ja OpenAI SDK vēl nav instalēts tavā projektā:
pip install openai
Konfigurē klientu priekš xAI
Vienīgā atšķirība no parastās OpenAI lietošanas ir parametrs base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Tas arī viss. No šī brīža katra OpenAI SDK metode darbojas ar Grok modeļiem.
Nosūti ziņojumu
Izsaukuma struktūra ir tāda pati kā GPT gadījumā, izņemot neatbalstītos parametrus (skatīt zemāk):
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)
Pieejamie modeļi
Vienkārši nomaini OpenAI modeļa nosaukumu uz Grok modeli:
grok-4.7: xAI ieteiktais modelis, universāls, ar attēlu ievades iespēju (grok-4.6ungrok-4.5joprojām ir pieejami)grok-4.20-0309-reasoning: uzlabota spriešanagrok-4.3: ātras un lētas atbildes (1M konteksts)
Migrē esošu OpenAI projektu
Lai pielāgotu esošu projektu, tev ir divas iespējas.
1. variants: Vides mainīgie
Maini mainīgos, nepieskaroties kodam:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
OpenAI SDK automātiski nolasīs šos mainīgos. Tavs esošais kods darbosies, ja nomainīsi arī modeļa nosaukumu un noņemsi parametrus, kurus xAI neatbalsta.
2. variants: Eksplicīta konfigurācija
Uzraksti inicializācijas funkciju, kas pārslēdzas starp nodrošinātājiem:
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 pēc noklusējuma
client = create_client("xai")
Šī pieeja ļauj migrācijas laikā viegli pārslēgties starp nodrošinātājiem.
Atšķirības, kas jāzina
Lai gan API ir saderīgs, daļa uzvedības atšķiras:
- Parametri
frequency_penaltyunpresence_penaltynetiek atbalstīti spriešanas modeļos - Parametrs
stopnav pieejams spriešanas modeļos logprobsuntop_logprobstiek klusi ignorēti modeļosgrok-4.20un jaunākos, betlogit_biasnetiek atbalstīts- Modeļu nosaukumi, protams, ir citi
- Dažas xAI funkcijas (X meklēšana, tīmekļa meklēšana) nav pieejamas, izmantojot standarta OpenAI formātu
Kad izvēlēties šo pieeju
Saderības režīms ir jēdzīgākais, ja tavs esošais kods ir svarīgāks par ekskluzīvām funkcijām. Visbiežākais gadījums ir migrācija: kods, kas jau rakstīts priekš OpenAI, pāriet uz Grok, mainot bāzes URL un atslēgu: divas rindiņas, bez pārrakstīšanas. Atgriezeniskums arī ir svarīgs: kamēr paliec OpenAI formātā, nodrošinātāja maiņa ir tikai konfigurācijas jautājums, kas ir vērtīgi, salīdzinot modeļus vai veicot sarunas. Tad ir ekosistēma: trešo pušu rīki, kas būvēti ap OpenAI SDK, piemēram, LangChain un LlamaIndex, strādā uzreiz, un komandai, kas jau pārzina SDK, nav jāapgūst nekas jauns. Cena, ko maksā, ir tā, ko redzēji iepriekš: xAI specifiskās funkcijas paliek otrajā plānā.
Galvenās atziņas
- Pievieno
base_url="https://api.x.ai/v1"konstruktoraOpenAI()izsaukumā - Nomaini API atslēgu un modeļa nosaukumu
- Mainīgie
OPENAI_BASE_URLunOPENAI_API_KEYļauj veikt migrāciju, nepieskaroties kodam - Daži parametri (sodi, stop) netiek atbalstīti spriešanas modeļos