Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

OpenAI SDK skirta Grok

Paskaita 6 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Panaudok tai, ką jau žinai apie OpenAI
  2. Diegimas
  3. Sukonfigūruok klientą xAI
  4. Siųsk žinutę
  5. Perkelk esamą „OpenAI“ projektą
  6. Svarbūs skirtumai
  7. Kada rinktis šį būdą
  8. Svarbiausi punktai

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 logprobs ir top_logprobs (ignoruojami nuo „grok-4.20“) bei logit_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 samprotavimas
  • grok-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_penalty ir presence_penalty nepalaikomi samprotavimo modeliuose
  • Parametras stop neprieinamas samprotavimo modeliuose
  • logprobs ir top_logprobs yra tyloje ignoruojami „grok-4.20“ ir naujesnių modelių, o logit_bias nepalaikomas
  • 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_URL ir OPENAI_API_KEY leidžia atlikti migraciją neliečiant kodo
  • Kai kurie parametrai (baudos, sustabdymas) nepalaikomi samprotavimo modeliuose