Dostępne modele
Na tej stronie
Poznaj dostępne modele
Ten punkt końcowy odpowiada na pytanie, które możesz błędnie uznać za oczywiste: jakie modele Twój zespół może faktycznie wywoływać i jaka jest ich aktualna cena. Dokumentacja publiczna opisuje ogólny katalog; API opisuje Twój katalog, w tym bieżące cenniki.
Różnica między nimi nie jest teoretyczna. Poziomy dostępu ewoluują, ceny się zmieniają, a ID skopiowane z półrocznego wpisu na blogu generuje trudny do zdiagnozowania błąd dostępu. Wyrób sobie nawyk odpytywania tego punktu końcowego zamiast polegania na założeniach – dzięki temu Twoje skrypty porównujące koszty pozostaną wiarygodne w czasie. Informacje te są kluczowe dla wyboru odpowiedniego modelu do Twojego przypadku użycia i budżetu.
Lista modeli
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odpowiedź zawiera dla każdego modelu:
- ID: dokładna nazwa do użycia w wywołaniach API (np.
grok-4.20-0309-reasoning) - Klaster: grupa serwerów hostująca model
- Cennik: cena za milion tokenów dla wejścia i wyjścia
- Możliwości: rozmiar kontekstu, obsługa multimediów itp.
Zastosowanie w zarządzaniu kluczami
To moment, w którym ten punkt końcowy staje się nieodzowny, a nie tylko praktyczny. ACL wskazujący nieistniejący model – ponieważ format ID uległ zmianie lub model został wycofany – nie zgłasza głośnego błędu: po prostu nic nie autoryzuje, a Ty kończysz, szukając przyczyny błędu w swoim kodzie. Zweryfikuj ID u źródła, zanim zablokujesz je w kluczu.
{
"acls": [
"api-key:model:grok-4.20-0309-reasoning",
"api-key:model:grok-4.3"
]
}
Jeśli ograniczasz klucz do konkretnych modeli, najpierw upewnij się za pomocą tego punktu końcowego, że są one dostępne dla Twojego zespołu.
Lista punktów końcowych ACL
Ta sama logika dotyczy punktów końcowych: poniższa lista jest wiążącym źródłem przy tworzeniu Twoich reguł ACL. Daje też użyteczny podgląd rzeczywistego zakresu klucza – klucz ograniczony do chat nie wygeneruje osadzeń ani nie przetworzy obrazów, niezależnie od modeli, do których się otherwise odwołuje.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dostępne punkty końcowe to:
- chat: konwersacje tekstowe (uzupełnienia czatu)
- embed: generowanie osadzeń
- image: generowanie i analiza obrazów
- models: lista modeli
- sample: próbkowanie
- tokenize: tokenizacja tekstu
- documents: przetwarzanie dokumentów
Wybierz odpowiedni model
Według przypadku użycia
| Przypadek użycia | Zalecany model | Dlaczego |
|---|---|---|
| Złożone wnioskowanie | grok-4.20-0309-reasoning | Zaawansowany łańcuch myślowy |
| Proste zadania, duża skala | grok-4.3 | Szybki, ekonomiczny |
| Analiza obrazów | Model multimodalny | Obsługa wizji |
| Osadzenia / RAG | Model osadzeń | Zoptymalizowany pod wyszukiwanie |
Według budżetu
Porównaj stawki zwracane przez API, a nie te, które masz w głowie. Logika arbitrażu jest zawsze taka sama: zadanie klasyfikacji lub ekstrakcji nie zyskuje niczego na modelu do wnioskowania, a płacisz jego cenę przy każdym wywołaniu – a właśnie takie zadania uruchamiasz tysiącami razy. Model do wnioskowania jest niezbędny przy złożonych analizach.
Skrypt porównujący modele
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Pobierz modele
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} {'Wejście ($/M)':<15} {'Wyjście ($/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}")
Monitoruj nowe modele
Katalog zmienia się kilka razy w roku, a najciekawsze zmiany to nie nowe modele, lecz spadki cen starych. Okresowe sprawdzenie porównujące stan z poprzednim zapisem wychwytuje oba typy zmian, a kosztuje tylko kilka linii w cronie.
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"
# Pobierz aktualne modele
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", [])}
# Porównaj z 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"Nowe modele: {', '.join(new_models)}")
if removed_models:
print(f"Usunięte modele: {', '.join(removed_models)}")
# Aktualizuj cache
with open(CACHE_FILE, "w") as f:
json.dump(list(current_models), f)
Połącz modele i analitykę
Ostateczne zestawienie krzyżowe decyduje o wyborze: z jednej strony koszt każdego modelu, z drugiej – jak bardzo go używasz. Drogi i marginalny model nie zasługuje na uwagę; drogi model pochłaniający większość żądań jest pierwszym kandydatem do zmiany i to właśnie ten skrypt uwidacznia w jednej linii.
# 1. Wylistuj dostępne modele
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json
# 2. Przeanalizuj użycie według modelu
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. Porównaj
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'Dostępne modele nieużywane: {unused}')
"
Cennik na dzień 5 sierpnia 2026 – ceny regularnie ewoluują: przed jakimkolwiek obliczeniem budżetu zweryfikuj aktualną siatkę na oficjalnej stronie modeli i cennika xAI.
Kluczowe wnioski
GET /auth/teams/{teamId}/modelswyświetla listę modeli z cennikiem i możliwościamiGET /auth/teams/{teamId}/endpointswyświetla listę punktów końcowych do reguł ACL- Wykorzystaj te informacje, aby tworzyć klucze API z precyzyjnymi regułami ACL
- Porównuj stawki, aby wybrać najbardziej ekonomiczny model dopasowany do Twojego użycia
- Regularnie monitoruj nowe dostępne modele