Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

OpenAI SDK priekš Grok

Nodarbība 6 no 14 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Izmanto savas OpenAI zināšanas
  2. Instalācija
  3. Konfigurē klientu priekš xAI
  4. Nosūti ziņojumu
  5. Migrē esošu OpenAI projektu
  6. Atšķirības, kas jāzina
  7. Kad izvēlēties šo pieeju
  8. Galvenās atziņas

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; logprobs un top_logprobs (tiek ignorēti, sākot no grok-4.20) un logit_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.6 un grok-4.5 joprojām ir pieejami)
  • grok-4.20-0309-reasoning: uzlabota spriešana
  • grok-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_penalty un presence_penalty netiek atbalstīti spriešanas modeļos
  • Parametrs stop nav pieejams spriešanas modeļos
  • logprobs un top_logprobs tiek klusi ignorēti modeļos grok-4.20 un jaunākos, bet logit_bias netiek 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" konstruktora OpenAI() izsaukumā
  • Nomaini API atslēgu un modeļa nosaukumu
  • Mainīgie OPENAI_BASE_URL un OPENAI_API_KEY ļauj veikt migrāciju, nepieskaroties kodam
  • Daži parametri (sodi, stop) netiek atbalstīti spriešanas modeļos