xAI API'en til udviklere
På denne side
Integrér Grok i dine applikationer
Alt det, du har lært at gøre i Grok-grænsefladen, kan udløses direkte fra din egen kode. xAI API’en bringer disse funktioner ind i dine apps, hjemmesider og tjenester: samtalen ophører med at være et sted, du besøger, og bliver i stedet en funktion, dit produkt kalder på.
Forudsætninger
Før du skriver din første linje kode, skal du bruge fire ting:
- En xAI-konto oprettet på accounts.x.ai
- En API-nøgle genereret på console.x.ai
- En betalingsmetode opsat (for at komme ud over den gratis kvote)
- Et udviklingsmiljø til Python eller JavaScript
De to første punkter har du allerede gennemgået i dette kursus: kontoen håndterer godkendelsen, og nøglen identificerer din applikation over for API’en. Betalingsmetoden bliver først relevant, når dit forbrug overstiger den gratis kvote, hvilket sker hurtigere, end du tror, så snart en tjeneste kører kontinuerligt. Hvad angår miljøet, har Python og JavaScript de bedste værktøjer, men da API’en taler HTTP, vil ethvert sprog, der kan sende en anmodning, gøre det.
Indledende opsætning
Det første skridt er at gemme din API-nøgle sikkert i en miljøvariabel:
export XAI_API_KEY="xai-your-key-here"
Hardkod aldrig din nøgle direkte i kildekoden. Årsagen er banal: en nøgle skrevet ind i en fil ender før eller siden i et Git-repository, og en nøgle, der push’es til et offentligt repository, bliver udnyttet inden for få minutter af bots, der scanner commits, mens regningen havner i dit navn.
Dernæst skal du vælge et SDK. Det native xAI SDK til Python installeres med pip install xai-sdk. Hvis din kode allerede kalder på OpenAI, fungerer biblioteket openai uden ændringer takket være formatkompatibilitet. På JavaScript-siden tilføjer du Vercel AI SDK med npm install ai @ai-sdk/xai, hvilket integrerer det med React- og Next.js-applikationer.
Din første anmodning
Med det native SDK kræver det kun tre linjer at oprette klienten og starte en samtale:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")
Ruten via OpenAI-kompatibilitet er lige så direkte: kun base_url ændres sammenlignet med eksisterende kode, hvilket er grunden til, at mange teams skifter over på få minutter.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.5",
input="Explain machine learning to me in 3 sentences."
)
For at tjekke, om en nøgle virker, før du overhovedet skriver kode, slår intet et kald fra kommandolinjen:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"input": "Hi, how are you?"
}'
Hvad API’en eksponerer
Fundamentet er tekstgenerering (konversationelle svar, skrivning, analyse) sammen med en ræsonnementsmode, der løser komplekse problemer trin for trin. Streaming tilføjer hertil ved at levere svaret token for token i stedet for at vente på, at genereringen er færdig.
Et andet sæt giver adgang til information: realtidssøgning på webbet og på X samt RAG, som spørger i dokumentsamlinger, du har opbygget. Den multimodale side dækker forståelse af billeder, du uploader, generering af billeder og videoer med grok-imagine samt tale med talte samtaler og TTS (tekst-til-tale).
Endelig gør tre mekanismer API’en programmerbar i streng forstand: function calling, der lader modellen kalde dine egne funktioner; strukturerede outputs, der garanterer brugbar JSON uden skrøbelig efterbehandling; og kodeeksekvering på serveren.
Vælg din model
Ræsonnementet varierer afhængigt af modellen. grok-4.7, flagskibet, tilbyder konfigurerbart ræsonnement: parameteren reasoning_effort (low, medium, high eller xhigh) indstiller, hvor dybt den tænker, anmodning for anmodning. grok-4.3 forbliver budgetvennen med meget lang kontekst til cirka halv pris. Der findes ikke-ræsonnerende versioner af modellerne til enkle opgaver: omskrivning eller klassificering behøver ikke intern overvejelse.
Navngivningskonventioner påvirker din applikations stabilitet:
grok-4.20: den seneste anbefalede stabile versiongrok-4.20-latest: den nyeste version (kan ændre sig)grok-4.20-0309: en version låst til en specifik dato (9. marts)
I produktion beskytter en låst version dine prompts mod stille ændringer i modellen; latest er fint til udforskning, så længe du accepterer, at adfærden kan skifte.
Rate limits og bedste praksis
API’en håndhæver rate limits for at holde tjenesten stabil: på entry-niveauet ca. 10 millioner tokens per minut og 1.800 anmodninger per minut for modeller som grok-4.3, og mere efterhånden som dit niveau stiger. Modeller til generering af billeder og videoer har deres egne, meget lavere grænser, fra 30 til 300 anmodninger per minut afhængigt af modellen, så hold øje med dem, hvis du driver en tjeneste rettet mod forbrugere.
Nogle få vaner adskiller en prototype fra en solid integration. Slå streaming til ved lange svar, fordi tredive sekunder foran en tom skærm føles som et nedbrud. Send et samtale-ID for at drage fordel af caching. Rout hver opgave til den rigtige model: grok-4.3 til simpelt volumen, grok-4.20 til ræsonnement. Håndtér fejl med genforsøg og eksponentiel backoff, ellers bliver en trafikspids til en lavine af afviste anmodninger. Og hold øje med dit forbrug i konsollen, før du opdager totalen ved månedens udgang.
Vigtige pointer
- xAI API’en er kompatibel med OpenAI-formatet, hvilket gør migration nem
- Flere SDK’er er tilgængelige: native xAI, OpenAI og Vercel AI SDK
- API’en dækker tekst, billeder, video, tale og søgning
- To niveauer af modeller: grok-4.7 (flagskib, konfigurerbart ræsonnement) og grok-4.3 (budget, 1M kontekst)
- Gem altid din API-nøgle i en miljøvariabel, aldrig hardkodet