Διαθέσιμα σημεία πρόσβασης (endpoints)
Σε αυτήν τη σελίδα
Επισκόπηση του 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) εμπλουτίζουν τις απαντήσεις χωρίς επιπλέον κώδικα