Grok API: anropa Grok från din egen kod

Två sätt att anropa Grok via kod

Utvecklare kan anropa Grok-modeller på två huvudsakliga sätt. Det första är xAI API, som drivs av företaget självt (nu under varumärket SpaceXSI), med nycklar från console.x.ai. Det andra är via en modellrouter som OpenRouter, som samlar många leverantörers modeller under en och samma nyckel och faktura. Båda tar emot förfrågningar i OpenAI Chat Completions-formatet, så de officiella OpenAI SDK:erna fungerar så fort du ändrar basadressen och modellnamnet.

Vilken väg ska du välja?

• xAI API om du vill ha alla Grok-funktioner först: hela listan med modeller, Responses API, verktyg för webb- och X-sökning på serversidan, bild- och videogenerering med Grok Imagine, röst, batch-jobb och rabatter för cachade prompter. Bas-URL: https://api.x.ai/v1.
• OpenRouter om du vill kunna växla mellan Grok och modeller från andra företag utan nya avtal, eller om du redan har ett OpenRouter-konto. Bas-URL: https://openrouter.ai/api/v1, med modell-ID:n som börjar på x-ai/. Instruktioner finns i OpenRouter quickstart.

Oavsett vilket alternativ du väljer ska nyckeln sparas på en server eller i en miljövariabel. Lägg den aldrig i en webbsida eller mobilapp där vem som helst kan läsa den.

Ditt första anrop till xAI API

Skapa en nyckel i konsolen, spara den som XAI_API_KEY och skicka ett meddelande till Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three tips for a first marathon."}
    ]
  }'

Python med OpenAI-biblioteket

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Is 391 a prime number? Show your check."}],
)
print(answer.choices[0].message.content)

reasoning_effort styr hur länge modellen tänker innan den svarar. Grok 4.3 stöder none, low, medium, high och xhigh, med low som standard. Grok 4.7 stöder low, medium, high och xhigh, med high som standard. För Grok 4.20 har xAI separata ID:n: grok-4.20-0309-reasoning och grok-4.20-0309-non-reasoning.

Samma sak via OpenRouter

På OpenRouter sparar du nyckeln i OPENROUTER_API_KEY och använder x-ai/-ID:n. OpenRouter styr tankeprocessen via ett reasoning-objekt istället. Den här JavaScript-koden körs i Node.js 18 eller senare:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Rewrite this headline in a calmer tone: PRICES EXPLODE AGAIN" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

För att aktivera tänkande skickar du reasoning: { effort: "low" } (eller medium, high) istället. Lägg till exclude: true om du vill att tänkandet ska användas men inte returneras. Sätt stream: true för att strömma svaret medan det genereras, vilket känns betydligt snabbare i ett chattgränssnitt.

Skicka en bild

Grok 4.20, 4.3 och 4.7 kan alla tolka bilder. Använd meddelandeformatet från OpenAI med en lista över delar. Enligt xAI:s dokumentation stöds JPEG- och PNG-bilder upp till 20 MiB; både en publik URL och en base64-data-URL fungerar.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "List the items and the total on this receipt."}
    ]
  }]
}

Grok modell-ID:n och priser

Här är de aktuella textmodellerna OpenRouter listar för SpaceXAI, med kontextstorlek och pris per miljon tokens (listpris på OpenRouter, okt 2026). xAI API tar samma baspriser för prompter under 200 000 tokens.

Några detaljer från xAI:s sida för modeller och priser (listpris hos xAI, okt 2026):

• Långa prompter kostar mer. När en prompt når 200 000 tokens debiteras hela anropet till den högre taxan: $4 / $12 för Grok 4.7, $2.50 / $5 för Grok 4.3 och 4.20.
• Cachad input är billigare: $0.50 per miljon för Grok 4.7 och $0.20 för Grok 4.3 och 4.20, för återkommande prompt-prefix.
• Batch-jobb som inte brådskar får rabatt, och OpenRouter listar även x-ai/grok-4.3:batch för $1 / $2.
• Kontextfönstret skiljer sig mellan källor: OpenRouter anger 2 000 000 tokens för Grok 4.20, medan xAI:s egen modellsida anger 1 000 000.

Tanketokens räknas som output, så en resonerande modell kan kosta mer per svar än vad priset per token antyder.

Praktiska tips

• Börja med Grok 4.20 non-reasoning för chatt, omskrivning och dataextraktion. Den är snabb och prisvärd. Gå över till Grok 4.3 eller 4.7 när kvaliteten vid svårare uppgifter är viktigare än snabbhet.
• Tänk på kunskapsgränsen. Grok 4.7 känner till händelser fram till maj 2026, enligt xAI. För färskare information skickar du med fakta direkt i prompten, eller använder xAI:s sökverktyg för webben och X på serversidan, vilka debiteras per anrop.
• Skriv ett systemmeddelande med roll, tonläge och önskat utdataformat, och be om JSON med ett schema om din kod ska parsa svaret.
• Hantera hastighetsbegränsningar (rate limits). Försök igen efter en kort paus om du får felkod 429.
• Följ användarvillkoren. xAI:s policy för tillåten användning gäller vid API-anrop, och parametern safety_identifier låter dig tagga anrop per slutanvändare.

När något går fel

• 401 eller 403: nyckeln saknas, är återkallad eller inläst i fel miljö. Skriv ut dess första tecken på servern för att bekräfta att den finns.
• Model not found: kontrollera prefixet. OpenRouter kräver x-ai/grok-4.7, medan xAI vill ha grok-4.7.
• Tomma eller mycket långsamma svar från en resonerande modell betyder oftast att den har förbrukat hela sin output-budget på att tänka. Sänk nivån på effort eller öka max_tokens.
• Bilden avvisas: konvertera den till JPEG eller PNG och se till att den håller sig under storleksgränsen.

Vanliga frågor

Är Grok API kompatibelt med OpenAI SDK?

Ja. Peka SDK:n mot https://api.x.ai/v1 med en xAI-nyckel, eller mot OpenRouter med en OpenRouter-nyckel, och ange ett modell-ID för Grok.

Finns det ett gratis Grok API?

Nej, det finns ingen permanent gratisnivå. Både xAI och OpenRouter tar betalt per token, men korta tester kostar väldigt lite.

Kan jag generera bilder med Grok API?

Ja, via xAI:s Grok Imagine-modeller på en separat bildslutpunkt. Läs mer på vår sida om Grok Imagine. Vår chatt kan inte skapa bilder.

Vilken Grok-modell använder Grok.Online?

Vår chatt erbjuder Grok 4.20 med tänkande avstängt, Grok 4.3 med low reasoning effort samt Grok 4.7 för upp till 10 meddelanden per dag – allt via OpenRouter.