xAI API för utvecklare
På denna sida
Integrera Grok i dina applikationer
Allt du har lärt dig att göra i Grok-gränssnittet kan utlösas från din egen kod. xAI API flyttar dessa möjligheter in i dina appar, webbplatser och tjänster: konversationen slutar vara en plats du besöker och blir istället en funktion som din produkt anropar.
Förutsättningar
Innan du skriver din första kodrad behöver du fyra saker:
- Ett xAI-konto skapat på accounts.x.ai
- En API-nyckel genererad på console.x.ai
- En registrerad betalningsmetod (för att gå utöver den kostnadsfria kvoten)
- En utvecklingsmiljö för Python eller JavaScript
De två första punkterna har du redan genomfört i denna kurs: kontot hanterar autentiseringen och nyckeln identifierar din applikation mot API:t. Betalningsmetoden behövs först när din användning överskrider den kostnadsfria kvoten, vilket sker snabbare än du tror så snart en tjänst körs kontinuerligt. Vad gäller miljön har Python och JavaScript de bästa verktygen, men eftersom API:t kommunicerar via HTTP fungerar vilket språk som helst som kan skicka en begäran.
Grundläggande konfiguration
Första steget är att lagra din API-nyckel säkert i en miljövariabel:
export XAI_API_KEY="xai-your-key-here"
Hardkoda aldrig din nyckel i källkoden. Anledningen är banal: en nyckel som skrivs i en fil hamnar förr eller senare i ett Git-repository, och en nyckel som pushas till ett offentligt repository utnyttjas inom minuter av botar som skannar commits, medan fakturan hamnar hos dig.
Nästa steg är att välja ett SDK. Det nativa xAI SDK:t för Python installeras med pip install xai-sdk. Om din kod redan anropar OpenAI fungerar biblioteket openai som det är, tack vare formatkompatibilitet. På JavaScript-sidan lägger du till Vercel AI SDK med npm install ai @ai-sdk/xai, vilket integreras med React- och Next.js-applikationer.
Din första begäran
Med det nativa SDK:t tar det tre rader att skapa klienten och öppna en konversation:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")
Vägen via OpenAI-kompatibilitet är lika direkt: endast base_url ändras jämfört med befintlig kod, vilket är varför många team byter på några minuter.
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."
)
För att kontrollera att en nyckel fungerar innan du ens skriver någon kod finns inget bättre än ett anrop från kommandoraden:
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?"
}'
Vad API:t exponerar
Grunderna är textgenerering (konversationssvar, skrivande, analys), tillsammans med ett resonemangsläge som löser komplexa problem steg för steg. Strömning lägger till detta genom att leverera svaret token för token istället för att vänta på att genereringen ska slutföras.
En andra uppsättning ger tillgång till information: realtidssökning på webben och på X, samt RAG, som frågar mot dokumentsamlingar du har byggt. Den multimodala sidan täcker förståelse av bilder du tillhandahåller, generering av bilder och videor med grok-imagine, samt röst, med talade konversationer och TTS.
Slutligen gör tre mekanismer API:t programmerbart i strikt mening: funktionsanrop, vilket låter modellen anropa dina egna funktioner; strukturerade utdata, som garanterar användbar JSON utan bräcklig efterbehandling; och kodexekvering på serversidan.
Välj din modell
Resonemangsformågan varierar mellan modeller. grok-4.7, flaggskeppet, erbjuder konfigurerbart resonemang: parametern reasoning_effort (low, medium, high eller xhigh) styr hur djupt den tänker, begäran för begäran. grok-4.3 förblir budgetalternativet med mycket lång kontext, till ungefär halva priset. Icke-resonerande versioner av modellerna finns för enkla uppgifter: omformulering eller klassificering behöver ingen intern överläggning.
Namngivningskonventioner påverkar din applikations stabilitet:
grok-4.20: den senaste rekommenderade stabila versionengrok-4.20-latest: den senaste versionen (kan ändras)grok-4.20-0309: en version låst till ett specifikt datum (9 mars)
I produktion skyddar en låst version dina prompts från tysta ändringar i modellen; latest fungerar bra för utforskning, så länge du accepterar att beteendet kan skifta.
Hastighetsbegränsningar och bästa praxis
API:t tillämpar hastighetsbegränsningar för att hålla tjänsten stabil: på instegsnivån cirka 10 miljoner tokens per minut och 1 800 begäranden per minut för modeller som grok-4.3, och mer efterhand som din nivå höjs. Modeller för bild- och videogenerering har sina egna, mycket lägre tak, från 30 till 300 begäranden per minut beroende på modell, så håll koll på dem för en konsumentinriktad tjänst.
Några vanor skiljer en prototyp från en solid integration. Aktivera strömning för långa svar, eftersom trettio sekunder framför en tom skärm känns som ett avbrott. Skicka ett konversations-ID för att dra nytta av cachelagring. Routa varje uppgift till rätt modell: grok-4.3 för enkel volym, grok-4.20 för resonemang. Hantera fel med försök och exponentiell backoff, annars förvandlas en trafiktopp till ett lavinartat flöde av avvisade begäranden. Och övervaka din användning i konsolen innan du upptäcker totalsumman i slutet av månaden.
Viktiga punkter
- xAI API är kompatibelt med OpenAI-formatet, vilket gör migrering enkel
- Flera SDK:n finns tillgängliga: native xAI, OpenAI och Vercel AI SDK
- API:t täcker text, bilder, video, röst och sökning
- Två nivåer av modeller: grok-4.7 (flaggskepp, konfigurerbart resonemang) och grok-4.3 (budget, 1M kontext)
- Lagra alltid din API-nyckel i en miljövariabel, aldrig hardkodad