Διαθέσιμα μοντέλα
Σε αυτήν τη σελίδα
Ανακαλύψτε τα διαθέσιμα μοντέλα
Αυτό το endpoint απαντά σε μια ερώτηση που ίσως λανθασμένα υποθέσετε ότι μπορείτε να διαχειριστείτε από μνήμης: ποια μοντέλα μπορεί πραγματικά να καλέσει η ομάδα σας και σε ποια τιμή σήμερα. Τα δημόσια έγγραφα περιγράφουν τον γενικό κατάλογο· το API περιγράφει τον δικό σας κατάλογο, συμπεριλαμβανομένων των τρεχουσών τιμολογήσεων.
Το χάσμα μεταξύ των δύο δεν είναι θεωρητικό. Τα επίπεδα εξελίσσονται, οι τιμές αλλάζουν και ένα ID αντιγραμμένο από μια ανάρτηση ιστολογίου έξι μηνών παράγει ένα σφάλμα πρόσβασης δύσκολο στη διάγνωση. Κάντε συνήθεια να κάνετε ερώτημα σε αυτό το endpoint αντί να κάνετε υποθέσεις· αυτό είναι επίσης που διατηρεί αξιόπιστα τα σενάρια σύγκρισης κόστους σας με την πάροδο του χρόνου. Αυτές οι πληροφορίες είναι απαραίτητες για την επιλογή του κατάλληλου μοντέλου για την περίπτωση χρήσης και τον προϋπολογισμό σας.
Λίστα μοντέλων
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Η απόκριση περιέχει για κάθε μοντέλο:
- ID: το ακριβές όνομα προς χρήση στις κλήσεις API (π.χ.
grok-4.20-0309-reasoning) - Cluster: η ομάδα διακομιστών που φιλοξενεί το μοντέλο
- Pricing: τιμή ανά εκατομμύριο tokens για είσοδο και έξοδο
- Capabilities: μέγεθος πλαισίου (context), υποστήριξη πολυτροπικότητας κ.λπ.
Χρήση στη διαχείριση κλειδιών
Εδώ είναι που το endpoint καθίσταται απαραίτητο και όχι απλώς πρακτικό. Ένα ACL που ονομάζει ένα ανύπαρκτο μοντέλο—επειδή η μορφή του ID άλλαξε ή το μοντέλο αποσύρθηκε—δεν αποτυγχάνει με θόρυβο: απλώς δεν εξουσιοδοτεί τίποτα, και καταλήγετε να ψάχνετε το σφάλμα στον κώδικά σας. Επαληθεύστε το ID στην πηγή πριν το κλειδώσετε σε ένα κλειδί.
{
"acls": [
"api-key:model:grok-4.20-0309-reasoning",
"api-key:model:grok-4.3"
]
}
Εάν περιορίσετε ένα κλειδί σε συγκεκριμένα μοντέλα, επαληθεύστε πρώτα ότι είναι διαθέσιμα στην ομάδα σας μέσω αυτού του endpoint.
Λίστα endpoints ACL
Η ίδια λογική ισχύει και για τα endpoints: η παρακάτω λίστα είναι η αυθεντική για τη σύνθεση των ACL σας. Παρέχει επίσης μια χρήσιμη επισκόπηση του πραγματικού πεδίου εφαρμογής ενός κλειδιού· ένα κλειδί περιορισμένο στο chat δεν μπορεί ούτε να παράγει ενσωματώσεις (embeddings) ούτε να επεξεργαστεί εικόνες, ανεξάρτητα από τα μοντέλα στα οποία αναφέρεται otherwise.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Τα διαθέσιμα endpoints είναι:
- chat: συνομιλίες κειμένου (chat completions)
- embed: δημιουργία ενσωματώσεων (embeddings)
- image: δημιουργία και ανάλυση εικόνων
- models: λίστα μοντέλων
- sample: δειγματοληψία (sampling)
- tokenize: tokenization κειμένου
- documents: επεξεργασία εγγράφων
Επιλέξτε το σωστό μοντέλο
Ανά περίπτωση χρήσης
| Περίπτωση χρήσης | Προτεινόμενο μοντέλο | Γιατί |
|---|---|---|
| Σύνθετος συλλογισμός | grok-4.20-0309-reasoning | Προηγμένη αλυσίδα σκέψης |
| Απλές εργασίες, υψηλός όγκος | grok-4.3 | Γρήγορο, οικονομικό |
| Ανάλυση εικόνων | Πολυτροπικό μοντέλο | Υποστήριξη όρασης |
| Ενσωματώσεις / RAG | Μοντέλο Embed | Βελτιστοποιημένο για αναζήτηση |
Ανά προϋπολογισμό
Συγκρίνετε τις τιμές που επιστρέφονται από το API και όχι αυτές που έχετε στο μυαλό σας. Η λογική της διαιτησίας είναι πάντα η ίδια: μια εργασία ταξινόμησης ή εξαγωγής δεν κερδίζει τίποτα από ένα μοντέλο συλλογισμού, ωστόσο πληρώνετε την τιμή του σε κάθε κλήση· και αυτός είναι ακριβώς ο τύπος εργασίας που εκτελείτε χιλιάδες φορές. Το μοντέλο συλλογισμού είναι απαραίτητο για σύνθετες αναλύσεις.
Σενάριο σύγκρισης μοντέλων
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Ανάκτηση μοντέλων
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}")
Παρακολούθηση νέων μοντέλων
Ο κατάλογος αλλάζει αρκετές φορές το χρόνο, και οι πιο ενδιαφέρουσες αλλαγές δεν είναι τα νέα μοντέλα αλλά οι μειώσεις τιμών στα παλιά. Ένας περιοδικός έλεγχος που συγκρίνει με την προηγούμενη εγγραφή επισημαίνει και τα δύο, και κοστίζει μερικές γραμμές 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"
# Ανάκτηση τρεχόντων μοντέλων
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", [])}
# Σύγκριση με την 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"New models: {', '.join(new_models)}")
if removed_models:
print(f"Removed models: {', '.join(removed_models)}")
# Ενημέρωση cache
with open(CACHE_FILE, "w") as f:
json.dump(list(current_models), f)
Συνδυάστε μοντέλα και αναλυτικά στοιχεία
Η τελική διασταύρωση είναι που οδηγεί την απόφαση: από τη μία πλευρά πόσο κοστίζει κάθε μοντέλο, από την άλλη πόσο το χρησιμοποιείτε. Ένα ακριβό και οριακό μοντέλο δεν αξίζει προσοχή· ένα ακριβό μοντέλο που απορροφά τον όγκο των αιτημάτων σας είναι ο πρώτος υποψήφιος για αλλαγή, και αυτό είναι που φέρνει στο φως αυτό το σενάριο σε μία γραμμή.
# 1. Λίστα διαθέσιμων μοντέλων
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json
# 2. Ανάλυση χρήσης ανά μοντέλο
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. Σύγκριση
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'Available models not used: {unused}')
"
Τιμολόγηση στις 5 Αυγούστου 2026 — οι τιμές εξελίσσονται τακτικά: πριν από οποιοδήποτε υπολογισμό προϋπολογισμού, επαληθεύστε το τρέχον πλέγμα στη επίσημη σελίδα μοντέλων και τιμολόγησης της xAI.
Βασικά σημεία
- Το
GET /auth/teams/{teamId}/modelsπαραθέτει μοντέλα με τιμολόγηση και δυνατότητες - Το
GET /auth/teams/{teamId}/endpointsπαραθέτει endpoints για ACLs - Χρησιμοποιήστε αυτές τις πληροφορίες για να δημιουργήσετε κλειδιά API με ακριβή ACLs
- Συγκρίνετε τις τιμές για να επιλέξετε το πιο οικονομικό μοντέλο που ταιριάζει στη χρήση σας
- Παρακολουθείτε τακτικά τα νέα διαθέσιμα μοντέλα