Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

xAI API και συμβατότητα με το OpenAI

Μάθημα 4 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Ένα οικείο API
  2. Ελάχιστη διαμόρφωση
  3. Απόκτηση κλειδιού API
  4. Διαθέσιμα endpoints
  5. Περιορισμοί συμβατότητας
  6. Βασικά σημεία

Ένα οικείο 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 σε οποιονδήποτε συμβατό πελάτη, πρέπει να αλλάξετε μόνο δύο παραμέτρους:

  1. Βασική διεύθυνση URL (Base URL): αντικαταστήστε το https://api.openai.com/v1 με το https://api.x.ai/v1
  2. Κλειδί 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

  1. Μεταβείτε στο console.x.ai
  2. Συνδεθείτε με τον λογαριασμό xAI (ή δημιουργήστε έναν στο accounts.x.ai)
  3. Στην ενότητα API Keys, δημιουργήστε ένα νέο κλειδί
  4. Αντιγράψτε το αμέσως· δεν θα εμφανιστεί ξανά

Φυλάξτε αυτό το κλειδί με ασφάλεια. Μην το καταχωρείτε ποτέ σε αποθετήριο 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