xAI's Python-SDK
På denne side
Opdateret 3. november 2026 baseret på xAI’s bedste praksis og API-reference: temperatur begrænset til 1 og anbefalet til 0,7. Kilde: Bedste praksis. Kodeeksemplet følger SDK README (
chat.append(user(...)),chat.sample(),response.content) og er blevet kørt for at verificere det.
xAI’s officielle Python-SDK
xAI’s native Python-SDK er den mest direkte måde at arbejde med Grok API’en på. Det eksponerer platformens specifikke funktioner og modtager opdateringer først, når nye modeller eller endpoints tilføjes.
Installation
Installér SDK’et med pip i dit Python-miljø:
pip install xai-sdk
Vi anbefaler at bruge et virtuelt miljø for at isolere afhængighederne for hvert projekt:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Initialisering af klienten
Klassen Client er SDK’ets indgangspunkt. Den håndterer godkendelse, HTTP-forbindelser og serialisering af anmodninger:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Hvis miljøvariablen XAI_API_KEY er sat, kan du også oprette klienten uden et eksplicit argument:
client = Client()
SDK’et registrerer variablen automatisk og bruger den til godkendelse.
Send en anmodning
Når klienten er initialiseret, tænker SDK’et i samtaler: client.chat.create() opretter samtalen (uden at sende noget), append tilføjer en besked bygget med user() eller system(), og sample() beder modellen om dens svar:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(model="grok-4.7")
chat.append(user("Forklar hvad en REST API er i 3 sætninger."))
response = chat.sample()
print(response.content)
Almindelige parametre
model: ID’et på modellen, der skal bruges (påkrævet); xAI anbefalergrok-4.7messages: Samtalens startbeskeder, bygget medsystem(),user()ogassistant()fraxai_sdk.chat(almindelige ordbøger får kaldet til at fejle)temperature: Fra 0 til 2, begrænset til 1 derover; xAI anbefaler 0,7 medtop_psat til 0,95max_tokens: Det maksimale antal tokens, der genereresreasoning_effort: Dybden af ræsonnementet (none,low,medium,high), hvilket xAI anbefaler at indstille ved hver anmodning
Streaming sker ikke via en parameter: for response, chunk in chat.stream(): returnerer fragmenterne, efterhånden som de ankommer i chunk.content. Lektion 10 viser streaming med REST API’en over SSE.
Fordele ved det native SDK
Sammenlignet med OpenAI SDK’et rettet mod xAI API’en (næste lektion), giver det native SDK direkte adgang til xAI-specifikke funktioner: X og websøgning, server-side værktøjer, videogenerering og dokumentsamlinger. Dets komplette Python-typer styrker din editors autoudfyldning, og xAI vedligeholder det i takt med API’en. Det har også sin egen form, som du må acceptere: det kører over gRPC, dets beskeder bygges med user() og system(), og dets fejl er grpc.RpcError.
Hvornår skal du vælge dette SDK?
Valget følger naturligt af din situation. Til et nyt projekt bygget specifikt på Grok API’en er det native SDK det åbenlyse udgangspunkt: du får alt ovenstående uden kompatibilitetsbegrænsninger, der skal overholdes. Det bliver essentielt, så snart du planlægger at bruge xAI-specifikke funktioner som X-søgning eller indbygget websøgning, som kun fungerer fuldt ud på denne måde. Hvis du derimod har eksisterende kode bygget på OpenAI SDK’et, så skriv ikke noget om lige nu: næste lektion viser, hvordan du tilpasser det ved at ændre to linjer.
Vigtige pointer
- Installér med
pip install xai-sdki et virtuelt miljø - Klassen
Clienter indgangspunktet med automatisk detektion afXAI_API_KEY client.chat.create()opretter en samtale;chat.append(user(...))tilføjer en besked, ogchat.sample()returnerer svaret, som læses fraresponse.content- Foretræk dette SDK til nye projekter, der kun målretter Grok API’en