Spring til hovedindhold
Dansk— Vælg et sprog
Menu

xAI's Python-SDK

Lektion 5 af 14 Opdateret 3. november 2026 Udvikler
På denne side
  1. xAI’s officielle Python-SDK
  2. Installation
  3. Initialisering af klienten
  4. Send en anmodning
  5. Fordele ved det native SDK
  6. Hvornår skal du vælge dette SDK?
  7. Vigtige pointer

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.

pip
Standardinstallation
Client
Hovedklasse
Auto
Automatisk API-nøgle-detektion
Native
Fuld xAI-understøttelse

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 anbefaler grok-4.7
  • messages: Samtalens startbeskeder, bygget med system(), user() og assistant() fra xai_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 med top_p sat til 0,95
  • max_tokens: Det maksimale antal tokens, der genereres
  • reasoning_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-sdk i et virtuelt miljø
  • Klassen Client er indgangspunktet med automatisk detektion af XAI_API_KEY
  • client.chat.create() opretter en samtale; chat.append(user(...)) tilføjer en besked, og chat.sample() returnerer svaret, som læses fra response.content
  • Foretræk dette SDK til nye projekter, der kun målretter Grok API’en