xAI API και συμβατότητα με το OpenAI
Σε αυτήν τη σελίδα
Ένα οικείο API
Το API της xAI χρησιμοποιεί την ίδια δομή με το API του OpenAI. Αν έχετε εργαστεί στο παρελθόν με το API του OpenAI ή με συμβατά εργαλεία, δεν χρειάζεται να μάθετε κάτι νέο. Το μόνο που αλλάζει είναι η βασική διεύθυνση URL (base URL).
https://api.x.ai/v1
Αυτή η συμβατότητα αποτελεί στρατηγική επιλογή της xAI. Αντί να επιβάλει μια νέα ιδιόκτητη μορφή, υιοθέτησε το de facto πρότυπο της βιομηχανίας. Ως αποτέλεσμα, οποιοδήποτε εργαλείο, SDK ή επεξεργαστής κώδικα που υποστηρίζει το API του OpenAI μπορεί να χρησιμοποιήσει άμεσα το grok-build-0.1.
Ελάχιστη διαμόρφωση
Για να μεταβείτε από το OpenAI στην xAI σε οποιονδήποτε συμβατό πελάτη, πρέπει να αλλάξετε μόνο δύο παραμέτρους:
- Βασική διεύθυνση URL (Base URL): αντικαταστήστε το
https://api.openai.com/v1με τοhttps://api.x.ai/v1 - Κλειδί API: χρησιμοποιήστε το κλειδί API της xAI (το οποίο λαμβάνετε από το
console.x.ai)
Όλα τα υπόλοιπα—η μορφή των μηνυμάτων, οι παράμετροι θερμοκρασίας, η δομή της απόκρισης—είναι πανομοιότυπα.
Παράδειγμα με το Python SDK του OpenAI
from openai import OpenAI
client = OpenAI(
api_key="your-xai-key",
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-build-0.1",
messages=[
{"role": "system", "content": "You are a programming assistant."},
{"role": "user", "content": "Write a quicksort function in Python."}
]
)
Χρησιμοποιείτε το τυπικό SDK του OpenAI χωρίς καμία τροποποίηση. Αλλάζουν μόνο το base_url και το όνομα του μοντέλου.
Παράδειγμα με curl
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer your-xai-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-build-0.1",
"messages": [
{"role": "user", "content": "Explain the difference between let and const in JavaScript"}
]
}'
Απόκτηση κλειδιού API
- Μεταβείτε στο console.x.ai
- Συνδεθείτε με τον λογαριασμό xAI (ή δημιουργήστε έναν στο accounts.x.ai)
- Στην ενότητα API Keys, δημιουργήστε ένα νέο κλειδί
- Αντιγράψτε το αμέσως· δεν θα εμφανιστεί ξανά
Φυλάξτε αυτό το κλειδί με ασφάλεια. Μην το καταχωρείτε ποτέ σε αποθετήριο Git και μην το κοινοποιείτε σε ομαδικές συνομιλίες. Χρησιμοποιήστε μια μεταβλητή περιβάλλοντος ή έναν διαχειριστή μυστικών (secrets manager).
Διαθέσιμα endpoints
Το grok-build-0.1 υποστηρίζει τα ακόλουθα endpoints, όλα σε μορφή OpenAI:
/v1/chat/completions: δημιουργία κειμένου και κώδικα (το πιο συχνά χρησιμοποιούμενο)/v1/chat/completionsμεstream: true: ροή δεδομένων (streaming) μεreasoning_content/v1/chat/completionsμεtools: εγγενής κλήση εργαλείων (native tool calling)
Περιορισμοί συμβατότητας
Υπάρχουν μερικές μικρές διαφορές:
- Τα διαθέσιμα μοντέλα είναι της xAI (grok-build-0.1, grok-4.5, κ.λπ.), όχι του OpenAI
- Ορισμένες παράμετροι ειδικές για το OpenAI (όπως το
logprobs) ενδέχεται να μην υποστηρίζονται - Το
reasoning_contentείναι ειδικό για το API της xAI και δεν υπάρχει στο API του OpenAI
Βασικά σημεία
- Το API της xAI βρίσκεται στο
https://api.x.ai/v1και είναι συμβατό με τη μορφή του OpenAI - Χρειάζεται να αλλάξετε μόνο τη βασική διεύθυνση URL και το κλειδί API για τη μετάβαση
- Το Python SDK του OpenAI λειτουργεί ως έχει
- Αποκτήστε το κλειδί API από το console.x.ai
- Όλοι οι επεξεργαστές συμβατοί με το OpenAI λειτουργούν με την xAI