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

Το API της xAI για προγραμματιστές

Μάθημα 15 / 16 Ενημερώθηκε 29 Ιουλίου 2026 Αρχάριος
Σε αυτήν τη σελίδα
  1. Ενσωμάτωση του Grok στις εφαρμογές σας
  2. Προαπαιτούμενα
  3. Αρχική ρύθμιση
  4. Το πρώτο σας αίτημα
  5. Τι εκθέτει το API
  6. Επιλογή του μοντέλου σας
  7. Όρια ρυθμού και βέλτιστες πρακτικές
  8. Βασικά σημεία

Ενσωμάτωση του Grok στις εφαρμογές σας

Όλα όσα μάθατε να κάνετε στη διεπαφή του Grok μπορούν να ενεργοποιηθούν απευθείας από τον κώδικά σας. Το API της xAI μεταφέρει αυτές τις δυνατότητες στις εφαρμογές, τους ιστότοπους και τις υπηρεσίες σας: η συνομιλία παύει να είναι ένας προορισμός και μετατρέπεται σε μια συνάρτηση που καλεί το προϊόν σας.

Προαπαιτούμενα

Πριν γράψετε την πρώτη γραμμή κώδικα, χρειάζεστε τέσσερα πράγματα:

  1. Έναν λογαριασμό xAI δημιουργημένο στο accounts.x.ai
  2. Ένα κλειδί API που δημιουργήθηκε στο console.x.ai
  3. Μια μέθοδο πληρωμής ρυθμισμένη (για να ξεπεράσετε το δωρεάν όριο)
  4. Ένα περιβάλλον ανάπτυξης Python ή JavaScript

Τα δύο πρώτα τα έχετε ήδη ολοκληρώσει σε αυτό το μάθημα: ο λογαριασμός διαχειρίζεται τον έλεγχο ταυτότητας και το κλειδί αναγνωρίζει την εφαρμογή σας στο API. Η μέθοδος πληρωμής τίθεται σε ισχύ μόνο όταν η χρήση σας υπερβεί το δωρεάν όριο, κάτι που συμβαίνει ταχύτερα από όσο νομίζετε μόλις μια υπηρεσία τρέχει συνεχώς. Όσον αφορά το περιβάλλον, η Python και η JavaScript διαθέτουν τα καλύτερα εργαλεία, αλλά δεδομένου ότι το API χρησιμοποιεί HTTP, οποιαδήποτε γλώσσα μπορεί να στείλει ένα αίτημα.

Αρχική ρύθμιση

Το πρώτο βήμα είναι η ασφαλής αποθήκευση του κλειδιού API σας σε μια μεταβλητή περιβάλλοντος:

export XAI_API_KEY="xai-your-key-here"

Μην ενσωματώνετε ποτέ το κλειδί σας απευθείας στον πηγαίο κώδικα. Ο λόγος είναι απλός: ένα κλειδί γραμμένο σε αρχείο καταλήγει αργά ή γρήγορα σε ένα αποθετήριο Git, και ένα κλειδί που αναρτάται σε δημόσιο αποθετήριο εκμεταλλεύεται μέσα σε λεπτά από bots που σαρώνουν τις δεσμεύσεις (commits), ενώ ο λογαριασμός παραμένει στο όνομά σας.

Στη συνέχεια, επιλέγετε ένα SDK. Το εγγενές SDK της xAI για Python εγκαθίσταται με την εντολή pip install xai-sdk. Αν ο κώδικάς σας καλεί ήδη το OpenAI, η βιβλιοθήκη openai λειτουργεί ως έχει, χάρη στη συμβατότητα μορφής. Στην πλευρά της JavaScript, προσθέτετε το Vercel AI SDK με την εντολή npm install ai @ai-sdk/xai, το οποίο ενσωματώνεται σε εφαρμογές React και Next.js.

Το πρώτο σας αίτημα

Με το εγγενές SDK, η δημιουργία του πελάτη και το άνοιγμα μιας συνομιλίας απαιτούν τρεις γραμμές κώδικα:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")

Η διαδρομή συμβατή με το OpenAI είναι εξίσου άμεση: αλλάζει μόνο το base_url σε σχέση με τον υπάρχοντα κώδικα, γι’ αυτό και πολλές ομάδες κάνουν τη μετάβαση σε λίγα λεπτά.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.5",
    input="Explain machine learning to me in 3 sentences."
)

Για να ελέγξετε ότι ένα κλειδί λειτουργεί πριν καν γράψετε κώδικα, τίποτα δεν ξεπερνά μια κλήση από τη γραμμή εντολών:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Hi, how are you?"
  }'

Τι εκθέτει το API

Η βάση είναι η παραγωγή κειμένου (συνομιλιακές απαντήσεις, συγγραφή, ανάλυση), μαζί με μια λειτουργία συλλογισμού που λύνει σύνθετα προβλήματα βήμα προς βήμα. Η ροή δεδομένων (streaming) προσθέτει σε αυτό παραδίδοντας την απάντηση token προς token, αντί να περιμένετε να ολοκληρωθεί η παραγωγή.

Ένα δεύτερο σύνολο παρέχει πρόσβαση σε πληροφορίες: αναζήτηση σε πραγματικό χρόνο στον ιστό και στο X, και RAG, το οποίο κάνει ερωτήματα σε συλλογές εγγράφων που έχετε δημιουργήσει. Η πολυτροπική πλευρά καλύπτει την κατανόηση εικόνων που παρέχετε, τη δημιουργία εικόνων και βίντεο με το grok-imagine, και τη φωνή, με προφορικές συνομιλίες και TTS.

Τέλος, τρεις μηχανισμοί καθιστούν το API προγραμματίσιμο με την αυστηρή έννοια: η κλήση συναρτήσεων (function calling), που επιτρέπει στο μοντέλο να καλεί τις δικές σας συναρτήσεις· οι δομημένες έξοδοι, που εγγυώνται usable JSON χωρίς εύθραυστη μετεπεξεργασία· και η εκτέλεση κώδικα στην πλευρά του διακομιστή.

Επιλογή του μοντέλου σας

Ο συλλογισμός διαφέρει ανά μοντέλο. Το grok-4.7, η ναυαρχίδα, προσφέρει διαμορφώσιμο συλλογισμό: η παράμετρος reasoning_effort (low, medium, high, ή xhigh) ορίζει πόσο βαθιά σκέφτεται, αίτημα προς αίτημα. Το grok-4.3 παραμένει η οικονομική επιλογή με πολύ μεγάλο πλαίσιο συμφραζομένων (context), σε περίπου τη μισή τιμή. Υπάρχουν εκδόσεις των μοντέλων χωρίς συλλογισμό για απλές εργασίες: η αναδιατύπωση ή η ταξινόμηση δεν χρειάζονται εσωτερική deliberation.

Οι συμβάσεις ονοματοδοσίας επηρεάζουν τη σταθερότητα της εφαρμογής σας:

  • grok-4.20: η τελευταία προτεινόμενη σταθερή έκδοση
  • grok-4.20-latest: η πιο πρόσφατη έκδοση (μπορεί να αλλάξει)
  • grok-4.20-0309: μια έκδοση καρφιτσωμένη σε συγκεκριμένη ημερομηνία (9 Μαρτίου)

Σε περιβάλλον παραγωγής, μια καρφιτσωμένη έκδοση προστατεύει τα prompts σας από σιωπηλές αλλαγές στο μοντέλο· το latest είναι κατάλληλο για εξερεύνηση, εφόσον αποδέχεστε ότι η συμπεριφορά μπορεί να μετατοπιστεί.

Όρια ρυθμού και βέλτιστες πρακτικές

Το API επιβάλλει όρια ρυθμού για να διατηρήσει την υπηρεσία σταθερή: στο βασικό επίπεδο, περίπου 10 εκατομμύρια tokens ανά λεπτό και 1.800 αιτήματα ανά λεπτό για μοντέλα όπως το grok-4.3, και περισσότερα καθώς ανεβαίνετε επίπεδο. Τα μοντέλα δημιουργίας εικόνων και βίντεο έχουν τα δικά τους, πολύ χαμηλότερα όρια, από 30 έως 300 αιτήματα ανά λεπτό ανάλογα με το μοντέλο, οπότε προσέξτε τα για υπηρεσίες απευθυνόμενες στον καταναλωτή.

Λίγες συνήθειες χωρίζουν ένα πρωτότυπο από μια στιβαρή ενσωμάτωση. Ενεργοποιήστε τη ροή δεδομένων (streaming) για μεγάλες απαντήσεις, επειδή τριάντα δευτερόλεπτα μπροστά σε μια κενή οθόνη μοιάζουν με διακοπή λειτουργίας. Περάστε ένα ID συνομιλίας για να επωφεληθείτε από την προσωρινή αποθήκευση (caching). Δρομολογήστε κάθε εργασία στο κατάλληλο μοντέλο: grok-4.3 για απλό όγκο, grok-4.20 για συλλογισμό. Διαχειριστείτε τα σφάλματα με επαναλήψεις και εκθετική καθυστέρηση (exponential backoff), διαφορετικά μια αιχμή κίνησης μετατρέπεται σε χιονοστιβάδα απορριφθέντων αιτημάτων. Και παρακολουθείτε τη χρήση σας στην κονσόλα πριν ανακαλύψετε το σύνολο στο τέλος του μήνα.

Βασικά σημεία

  • Το API της xAI είναι συμβατό με τη μορφή του OpenAI, γεγονός που καθιστά τη μετάβαση εύκολη
  • Διατίθενται διάφορα SDK: το εγγενές xAI, το OpenAI και το Vercel AI SDK
  • Το API καλύπτει κείμενο, εικόνες, βίντεο, φωνή και αναζήτηση
  • Δύο επίπεδα μοντέλων: grok-4.7 (ναυαρχίδα, διαμορφώσιμος συλλογισμός) και grok-4.3 (οικονομικό, πλαίσιο 1M)
  • Αποθηκεύετε πάντα το κλειδί API σας σε μεταβλητή περιβάλλοντος, ποτέ ενσωματωμένο στον κώδικα