Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Tilgængelige modeller

Lektion 12 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Opdag tilgængelige modeller
  2. List modeller
  3. Brug i nøglehåndtering
  4. List ACL-endpoints
  5. Vælg den rigtige model
  6. Script til sammenligning af modeller
  7. Overvåg nye modeller
  8. Kombinér modeller og analytics
  9. Vigtige pointer

Opdag tilgængelige modeller

Dette endpoint svarer på et spørgsmål, du måske fejlagtigt tror, du kan huske i hovedet: Hvilke modeller dit team faktisk kan kalde på, og til hvilken pris i dag. Offentlig dokumentation beskriver det generelle katalog; API’et beskriver dit katalog, inklusive den aktuelle prissætning.

Kløften mellem de to er ikke teoretisk. Niveauer udvikler sig, priser ændrer sig, og en ID kopieret fra et blogindlæg for seks måneder siden giver en adgangsfejl, der er svær at diagnosticere. Gør det til en vane at spørge dette endpoint i stedet for at antage noget – det er også det, der holder dine scripts til sammenligning af omkostninger pålidelige over tid. Disse oplysninger er afgørende for at vælge den rigtige model til dit brugstilfælde og budget.

List modeller

curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Svaret indeholder for hver model:

  • ID: Det nøjagtige navn, der skal bruges i API-kald (f.eks. grok-4.20-0309-reasoning)
  • Cluster: Den servergruppe, der hoster modellen
  • Pricing: Pris per million tokens for input og output
  • Capabilities: Kontekststørrelse, multimodal understøttelse osv.

Brug i nøglehåndtering

Her bliver endpointet uundværligt frem for blot praktisk. En ACL, der nævner en ikke-eksisterende model – fordi ID-formatet er ændret, eller modellen er udgået – fejler ikke højlydt: Den autoriserer blot ingenting, og du ender med at lede efter fejlen i din kode. Verificér ID’et ved kilden, før du låser det fast i en nøgle.

{
  "acls": [
    "api-key:model:grok-4.20-0309-reasoning",
    "api-key:model:grok-4.3"
  ]
}

Hvis du begrænser en nøgle til specifikke modeller, skal du først verificere, at de er tilgængelige for dit team via dette endpoint.

List ACL-endpoints

Den samme logik gælder for endpoints: Listen nedenfor er den autoritative kilde til sammensætning af dine ACL’er. Den giver også et nyttigt overblik over en nøgles faktiske omfang – en nøgle begrænset til chat kan hverken generere embeddings eller behandle billeder, uanset hvilke modeller den ellers refererer til.

curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

De tilgængelige endpoints er:

  • chat: Tekstsamtaler (chat completions)
  • embed: Generering af embeddings
  • image: Billedgenerering og -analyse
  • models: Modelliste
  • sample: Sampling
  • tokenize: Tekst-tokenisering
  • documents: Dokumentbehandling

Vælg den rigtige model

Efter brugstilfælde

BrugstilfældeAnbefalet modelHvorfor
Kompleks ræsonnementgrok-4.20-0309-reasoningAvanceret tankekæde
Enkle opgaver, højt volumengrok-4.3Hurtig, økonomisk
BilledanalyseMultimodal modelVision-understøttelse
Embeddings / RAGEmbed-modelOptimeret til søgning

Efter budget

Sammenlign de satser, som API’et returnerer, i stedet for dem, du har i tankerne. Arbitrage-logikken er altid den samme: En klassificerings- eller ekstraktionsopgave får ingen fordel af en ræsonnementsmodel, alligevel betaler du dens pris for hvert kald – og det er præcis den type opgave, du kører tusindvis af gange. Ræsonnementsmodellen er nødvendig for komplekse analyser.

Script til sammenligning af modeller

import requests
import json

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Hent modeller
response = requests.get(
    f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/models",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

models = response.json().get("models", [])

print(f"{'Model':<35} {'Input ($/M)':<15} {'Output ($/M)':<15}")
print("-" * 65)

for model in models:
    name = model.get("id", "N/A")
    input_price = model.get("inputPrice", "N/A")
    output_price = model.get("outputPrice", "N/A")
    print(f"{name:<35} {input_price:<15} {output_price:<15}")

Overvåg nye modeller

Kataloget ændrer sig flere gange om året, og de mest interessante ændringer er ikke nye modeller, men prisfald på gamle. Et periodisk tjek, der sammenligner med den tidligere registrering, flagrer begge dele og koster kun et par linjer i cron.

import requests
import json
import os

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
CACHE_FILE = "/tmp/xai_models_cache.json"

# Hent aktuelle modeller
response = requests.get(
    f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/models",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_models = {m["id"] for m in response.json().get("models", [])}

# Sammenlign med cache
if os.path.exists(CACHE_FILE):
    with open(CACHE_FILE) as f:
        cached_models = set(json.load(f))

    new_models = current_models - cached_models
    removed_models = cached_models - current_models

    if new_models:
        print(f"Nye modeller: {', '.join(new_models)}")
    if removed_models:
        print(f"Fjernede modeller: {', '.join(removed_models)}")

# Opdater cache
with open(CACHE_FILE, "w") as f:
    json.dump(list(current_models), f)

Kombinér modeller og analytics

Den endelige krydsreferencing er det, der driver beslutningen: På den ene side hvad hver model koster, på den anden hvor meget du bruger den. En dyr og marginal model fortjener ikke opmærksomhed; en dyr model, der absorberer hovedparten af dine forespørgsler, er den første kandidat til ændring, og det er præcis det, dette script bringer frem i lyset på én linje.

# 1. List tilgængelige modeller
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json

# 2. Analyser brug efter model
curl -s -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analyticsRequest": {
      "timeRange": {
        "startTime": "2026-03-01 00:00:00",
        "endTime": "2026-04-01 00:00:00",
        "timezone": "UTC"
      },
      "timeUnit": "MONTH",
      "values": [{"name": "tokens", "aggregation": "SUM"}],
      "groupBy": ["model"]
    }
  }' > /tmp/usage.json

# 3. Sammenlign
python3 -c "
import json
with open('/tmp/models.json') as f:
    available = {m['id'] for m in json.load(f).get('models', [])}
with open('/tmp/usage.json') as f:
    used = {p.get('model') for p in json.load(f).get('dataPoints', [])}
unused = available - used
if unused:
    print(f'Tilgængelige modeller, der ikke bruges: {unused}')
"

Priser pr. 5. august 2026 – priserne ændrer sig regelmæssigt: Før enhver budgetberegning skal du verificere den aktuelle takst på den officielle xAI-side for modeller og priser.

Vigtige pointer

  • GET /auth/teams/{teamId}/models lister modeller med priser og funktioner
  • GET /auth/teams/{teamId}/endpoints lister endpoints til ACL’er
  • Brug disse oplysninger til at oprette API-nøgler med præcise ACL’er
  • Sammenlign satser for at vælge den mest økonomiske model, der passer til din brug
  • Overvåg regelmæssigt nye tilgængelige modeller