Przejdź do głównej treści
Polski— Wybierz język
Menu

Dostępne modele

Lekcja 12 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Poznaj dostępne modele
  2. Lista modeli
  3. Zastosowanie w zarządzaniu kluczami
  4. Lista punktów końcowych ACL
  5. Wybierz odpowiedni model
  6. Skrypt porównujący modele
  7. Monitoruj nowe modele
  8. Połącz modele i analitykę
  9. Kluczowe wnioski

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życiaZalecany modelDlaczego
Złożone wnioskowaniegrok-4.20-0309-reasoningZaawansowany łańcuch myślowy
Proste zadania, duża skalagrok-4.3Szybki, ekonomiczny
Analiza obrazówModel multimodalnyObsługa wizji
Osadzenia / RAGModel 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}/models wyświetla listę modeli z cennikiem i możliwościami
  • GET /auth/teams/{teamId}/endpoints wyś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