Tillgängliga modeller
På denna sida
Upptäck tillgängliga modeller
Denna endpoint svarar på en fråga du kanske felaktigt tror att du kan besvara ur minnet: vilka modeller ditt team faktiskt kan anropa, och till vilket pris idag. Offentlig dokumentation beskriver den generella katalogen; API:t beskriver din katalog, inklusive gällande prissättning.
Klyftan mellan dessa två är inte teoretisk. Nivåer utvecklas, priser förändras, och ett ID kopierat från ett sex månader gammalt blogginlägg ger ett åtkomstfel som är svårt att diagnostisera. Gör det till en vana att fråga denna endpoint istället för att gissa – det är också detta som håller dina skript för kostnadsjämförelser tillförlitliga över tid. Denna information är avgörande för att välja rätt modell för ditt användningsområde och din budget.
Lista modeller
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret innehåller för varje modell:
- ID: det exakta namnet att använda i API-anrop (t.ex.
grok-4.20-0309-reasoning) - Cluster: servergruppen som hostar modellen
- Prissättning: pris per miljon tokens för inmatning och utmatning
- Kapaciteter: kontextstorlek, multimodalt stöd, etc.
Användning i nyckelhantering
Här blir endpointen oumbärlig snarare än bara praktisk. En ACL som nämner en modell som inte existerar – eftersom ID-formatet ändrats eller modellen tagits bort – misslyckas inte högljutt: den auktoriserar helt enkelt ingenting, och du hamnar leta efter felet i din kod. Verifiera ID:t vid källan innan du låser in det i en nyckel.
{
"acls": [
"api-key:model:grok-4.20-0309-reasoning",
"api-key:model:grok-4.3"
]
}
Om du begränsar en nyckel till specifika modeller, verifiera först att de är tillgängliga för ditt team via denna endpoint.
Lista ACL-endpoints
Samma logik gäller för endpoints: listan nedan är den auktoritativa för att komponera dina ACL:er. Den ger också en användbar vy av en nyckels faktiska omfång – en nyckel begränsad till chat kan varken generera inbäddningar eller bearbeta bilder, oavsett vilka modeller den annars refererar till.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
De tillgängliga endpoints är:
- chat: textkonversationer (chat completions)
- embed: generering av inbäddningar
- image: bildgenerering och analys
- models: modellista
- sample: sampling
- tokenize: texttokenisering
- documents: dokumentbearbetning
Välj rätt modell
Efter användningsområde
| Användningsområde | Rekommenderad modell | Varför |
|---|---|---|
| Komplex resonemang | grok-4.20-0309-reasoning | Avancerad kedja av tankar |
| Enkla uppgifter, hög volym | grok-4.3 | Snabb, ekonomisk |
| Bildanalys | Multimodal modell | Stöd för vision |
| Inbäddningar / RAG | Embed-modell | Optimerad för sökning |
Efter budget
Jämför de satser som returneras av API:t snarare än de du har i åtanke. Arbitragelogiken är alltid densamma: en klassificerings- eller extraktionsuppgift får ingen fördel av en resonemangsmodell, ändå betalar du dess pris vid varje anrop – och detta är precis den typ av uppgift du kör tusentals gånger. Resonemangsmodellen är nödvändig för komplexa analyser.
Skript för modelljämförelse
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Hämta 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"{'Modell':<35} {'Inmatning ($/M)':<15} {'Utmatning ($/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}")
Övervaka nya modeller
Katalogen ändras flera gånger om året, och de mest intressanta ändringarna är inte nya modeller utan prisfall på gamla. En periodisk kontroll som jämför mot tidigare register flaggar båda, och kostar bara några rader 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"
# Hämta aktuella 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", [])}
# Jämför 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"Nya modeller: {', '.join(new_models)}")
if removed_models:
print(f"Borttagna modeller: {', '.join(removed_models)}")
# Uppdatera cache
with open(CACHE_FILE, "w") as f:
json.dump(list(current_models), f)
Kombinera modeller och analys
Den slutgiltiga korsreferensen är det som driver beslutet: å ena sidan vad varje modell kostar, å andra sidan hur mycket du använder den. En dyr och marginell modell förtjänar ingen uppmärksamhet; en dyr modell som absorberar bulkdelen av dina förfrågningar är den första kandidaten för förändring, och detta är vad detta skript belyser på en rad.
# 1. Lista tillgängliga modeller
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json
# 2. Analysera användning per modell
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. Jämför
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'Tillgängliga modeller som inte används: {unused}')
"
Priser från och med 5 augusti 2026 — priser utvecklas regelbundet: innan någon budgetberäkning, verifiera den aktuella prislistan på den officiella xAI-sidan för modeller och prissättning.
Viktiga punkter
GET /auth/teams/{teamId}/modelslistar modeller med prissättning och kapaciteterGET /auth/teams/{teamId}/endpointslistar endpoints för ACL:er- Använd denna information för att skapa API-nycklar med precisa ACL:er
- Jämför satser för att välja den mest ekonomiska modellen anpassad till din användning
- Övervaka regelbundet nya tillgängliga modeller