Tilgængelige modeller
På denne side
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ælde | Anbefalet model | Hvorfor |
|---|---|---|
| Kompleks ræsonnement | grok-4.20-0309-reasoning | Avanceret tankekæde |
| Enkle opgaver, højt volumen | grok-4.3 | Hurtig, økonomisk |
| Billedanalyse | Multimodal model | Vision-understøttelse |
| Embeddings / RAG | Embed-model | Optimeret 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}/modelslister modeller med priser og funktionerGET /auth/teams/{teamId}/endpointslister 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