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

Διαθέσιμα σημεία πρόσβασης (endpoints)

Μάθημα 13 / 14 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Επισκόπηση του Grok API
  2. Δημιουργία κειμένου
  3. Ασύγχρονη επεξεργασία
  4. Δημιουργία εικόνων
  5. Δημιουργία βίντεο
  6. Σύνθεση ομιλίας
  7. Πράκτορας φωνής σε πραγματικό χρόνο
  8. Διαχείριση αρχείων
  9. Επεξεργασία παρτίδων (Batch processing)
  10. Ενσωματωμένα εργαλεία διακομιστή
  11. Βασικά σημεία

Επισκόπηση του Grok API

Το xAI API δεν περιορίζεται μόνο στη δημιουργία κειμένου. Εκθέτει ένα σύνολο σημείων πρόσβασης (endpoints) που καλύπτουν τη δημιουργία εικόνων και βίντεο, τη σύνθεση ομιλίας, τη διαχείριση αρχείων και την ασύγχρονη επεξεργασία. Αυτό το μάθημα χαρτογραφεί τα διαθέσιμα σημεία πρόσβασης, ώστε να γνωρίζετε ποιες λειτουργίες να χρησιμοποιήσετε στα έργα σας.

Δημιουργία κειμένου

POST /v1/responses (συνιστάται)

Το κύριο σημείο πρόσβασης για κάθε αλληλεπίδραση με τα μοντέλα Grok. Υποστηρίζει κείμενο, όραση, εργαλεία (κλήση συναρτήσεων), αναζήτηση στον ιστό και αναζήτηση στο X.

Βασικές παράμετροι: model, input, instructions, stream, tools, reasoning.

POST /v1/chat/completions (συμβατό με OpenAI)

Το σημείο πρόσβασης σε μορφή OpenAI, το οποίο διατηρείται για συμβατότητα με υπάρχοντα εργαλεία. Δέχεται τις ίδιες παραμέτρους με το API της OpenAI: model, messages, temperature, stream, tools.

GET /v1/responses/{id}

Ανακτά μια προηγούμενη απάντηση που δημιουργήθηκε, εφόσον αυτή αποθηκεύτηκε (παράμετρος store: true). Οι απαντήσεις διατηρούνται για 30 ημέρες.

DELETE /v1/responses/{id}

Διαγράφει μια αποθηκευμένη απάντηση πριν λήξει αυτόματα μετά από 30 ημέρες.

Ασύγχρονη επεξεργασία

POST /v1/chat/completions (καθυστερημένη λειτουργία)

Όταν προσθέτετε "deferred": true στο αίτημα, το API επιστρέφει αμέσως ένα request_id χωρίς να περιμένει την ολοκλήρωση της δημιουργίας. Είναι χρήσιμο για μακροχρόνια αιτήματα ή επεξεργασία παρτίδων (batch processing).

GET /v1/chat/deferred-completion/{request_id}

Ανακτά το αποτέλεσμα μιας ασύγχρονης κλήσης:

  • HTTP 200: η δημιουργία ολοκληρώθηκε και το σώμα της απόκρισης περιέχει την πλήρη απάντηση
  • HTTP 202: η δημιουργία είναι ακόμη σε εξέλιξη, οπότε δοκιμάστε ξανά αργότερα

Δημιουργία εικόνων

POST /v1/images/generations

Δημιουργεί εικόνες από μια περιγραφή κειμένου.

POST /v1/images/edits

Επεξεργάζεται μια υπάρχουσα εικόνα με βάση οδηγίες κειμένου.

Δημιουργία βίντεο

POST /v1/videos/generations

Ξεκινά τη δημιουργία βίντεο από μια προτροπή κειμένου.

GET /v1/videos/{id}

Ελέγχει την κατάσταση ενός βίντεο που δημιουργείται και ανακτά το URL του αποτελέσματος μόλις ολοκληρωθεί.

POST /v1/videos/edits

Επεξεργάζεται ένα υπάρχον βίντεο.

POST /v1/videos/extensions

Επεκτείνει ένα υπάρχον βίντεο.

Σύνθεση ομιλίας

POST /v1/tts

Μετατρέπει κείμενο σε ήχο (text-to-speech). Χρήσιμο για τη δημιουργία φωνητικών βοηθών ή αυτοματοποιημένου ηχητικού περιεχομένου.

Πράκτορας φωνής σε πραγματικό χρόνο

WSS wss://api.x.ai/v1/realtime

Ένα σημείο πρόσβασης WebSocket για τη δημιουργία διαδραστικών φωνητικών πρακτόρων. Η επικοινωνία πραγματοποιείται σε πραγματικό χρόνο, με αποστολή και λήψη ήχου.

Διαχείριση αρχείων

POST /v1/files

Ανεβάζει ένα αρχείο στην πλατφόρμα xAI. Τα αρχεία μπορούν στη συνέχεια να χρησιμοποιηθούν για RAG (δημιουργία εμπλουτισμένη με ανάκτηση) με συλλογές.

GET /v1/files

Εμφανίζει τη λίστα όλων των αρχείων που έχουν ανεβεί στον χώρο σας.

GET /v1/files/{id}

Ανακτά τα μεταδεδομένα ενός συγκεκριμένου αρχείου.

DELETE /v1/files/{id}

Διαγράφει ένα ανεβασμένο αρχείο.

Επεξεργασία παρτίδων (Batch processing)

POST /v1/batches

Δημιουργεί μια παρτίδα αιτημάτων για επεξεργασία ως ομάδα, συχνά με μειωμένη τιμή.

GET /v1/batches

Εμφανίζει τη λίστα των παρτίδων που είναι σε εξέλιξη και αυτών που έχουν ολοκληρωθεί.

Ενσωματωμένα εργαλεία διακομιστή

Το σημείο πρόσβασης /v1/responses υποστηρίζει εργαλεία που εκτελεί απευθείας το API, χωρίς λογική στην πλευρά του πελάτη:

  • web_search: αναζήτηση στον ιστό σε πραγματικό χρόνο
  • x_search: αναζήτηση σε αναρτήσεις του X (Twitter)
  • code_interpreter: εκτέλεση κώδικα Python
  • function: προσαρμοσμένες κλήσεις συναρτήσεων (function calling)

Ενεργοποιείτε αυτά τα εργαλεία μέσω της παραμέτρου tools του αιτήματος.

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

  • Το API καλύπτει κείμενο, εικόνες, βίντεο, ήχο και αρχεία
  • Το /v1/responses είναι το κύριο σημείο πρόσβασης, με την πιο πλήρη υποστήριξη
  • Η λειτουργία deferred επιτρέπει την ασύγχρονη επεξεργασία για μακροχρόνια αιτήματα
  • Τα εργαλεία διακομιστή (web_search, x_search, code_interpreter) εμπλουτίζουν τις απαντήσεις χωρίς επιπλέον κώδικα