Τερματικά σημεία που υποστηρίζονται σε παρτίδες
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 2 Νοεμβρίου 2026, βάσει της τεκμηρίωσης της xAI: η έκπτωση παρτίδας είναι 20% στα επιλέξιμα μοντέλα κειμένου (όχι 50%), τα παραδείγματα ακολουθούν το REST API και το επίσημο
xai-sdk(client.batch.*· το Batch API της xAI δεν χρησιμοποιεί τη μορφή της OpenAI, επομένως το SDK της OpenAI δεν εφαρμόζεται), και το Responses API έχει προτεραιότητα έναντι του Chat Completions, το οποίο αποτελεί παρωχημένο τερματικό σημείο στην xAI. Πηγές: Batch API · Αναφορά REST · Τιμολόγηση παρτίδας.
Επτά τερματικά σημεία, μία ροή εργασίας
Το Batch API δεν περιορίζεται στη δημιουργία κειμένου. Δέχεται επτά τερματικά σημεία που καλύπτουν κείμενο, εικόνες και βίντεο, ενώ μπορείτε να τα συνδυάσετε σε μία μόνο παρτίδα για να δημιουργήσετε πλήρεις πολυτροπικές ροές εργασίας σε μία ενέργεια.
Τερματικά σημεία κειμένου
/v1/responses — Το Responses API, το οποίο προτείνει η xAI. Σας παρέχει πρόσβαση σε εργαλεία πλευράς διακομιστή (αναζήτηση στον ιστό, αναζήτηση στο X, εκτέλεση κώδικα, MCP), κλήση συναρτήσεων και δομημένες εξόδους, ενώ λαμβάνει πρώτο τις νέες λειτουργίες.
/v1/chat/completions — Το αρχικό τερματικό σημείο ολοκλήρωσης, στη μορφή της OpenAI. Η xAI το διατηρεί ως παρωχημένο τερματικό σημείο: παραμένει χρήσιμο για υπάρχοντα κώδικα γραμμένο γι’ αυτό, αλλά μια νέα ροή εργασίας είναι προτιμότερο να ξεκινά με το Responses.
Στα επιλέξιμα μοντέλα, η έκπτωση παρτίδας 20% ισχύει και για τα δύο τερματικά σημεία, σε όλους τους τύπους token.
Τερματικά σημεία εικόνων
/v1/images/generations — Δημιουργεί εικόνες από μια προτροπή. Οι παράμετροι που θα χρησιμοποιήσετε είναι το aspect_ratio (για παράδειγμα "16:9"), το resolution ("1k", "1.5k" ή "2k"), το n για τον αριθμό των εικόνων και το response_format ("url" ή "b64_json").
/v1/images/edits — Επεξεργάζεται μια υπάρχουσα εικόνα, η οποία ορίζεται από ένα αντικείμενο image που περιέχει ένα url (μια δημόσια διεύθυνση ή δεδομένα κωδικοποιημένα σε base64) ή το file_id ενός μεταφορτωμένου αρχείου. Χρήσιμο για την εκτέλεση μετασχηματισμών σε σειρά σε έναν οπτικό κατάλογο.
Οι εικόνες χρεώνονται με τον κανονικό συντελεστή, χωρίς έκπτωση παρτίδας: εδώ η αξία της ομαδοποίησης είναι επιχειρησιακή και όχι οικονομική.
Τερματικά σημεία βίντεο
/v1/videos/generations (ή /v1/videos) — Δημιουργεί βίντεο από μια προτροπή, διάρκειας 1 έως 15 δευτερολέπτων (duration, 8 από προεπιλογή), σε ανάλυση 480p, 720p ή 1080p.
/v1/videos/edits — Επεξεργάζεται ένα υπάρχον βίντεο, το οποίο περνάει μέσα από ένα αντικείμενο video (η URL ενός αρχείου .mp4 ή ένα file_id).
/v1/videos/extensions — Επεκτείνει ένα βίντεο με ένα νέο τμήμα 2 έως 10 δευτερολέπτων.
Όπως και με τις εικόνες, η τιμολόγηση βίντεο παραμένει στον κανονικό συντελεστή σε λειτουργία παρτίδας. Τα αποτελέσματα εικόνων και βίντεο επιστρέφουν ως υπογεγραμμένες URLs που λήγουν μετά από μία ώρα.
Συνδυασμός τερματικών σημείων σε μια παρτίδα
Σε ένα αρχείο JSONL, κάθε γραμμή ορίζει το τερματικό της σημείο στο πεδίο url:
{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Summarize this article: ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a neighborhood bookstore"}}
Με αυτόν τον τρόπο, θα μπορούσατε να δημιουργήσετε τις περιγραφές των προϊόντων σας και τα οπτικά τους στοιχεία στην ίδια παρτίδα.
Επιλογή του κατάλληλου τερματικού σημείου
- Responses: η προεπιλεγμένη επιλογή, απαραίτητη μόλις χρειάζεστε εργαλεία πλευράς διακομιστή, δομημένες εξόδους ή τις νεότερες λειτουργίες
- Chat Completions: συνέχεια για κώδικα ήδη γραμμένο στη μορφή Chat Completions, και τίποτα περισσότερο
- Εικόνες και βίντεο: για την παραγωγή οπτικού υλικού σε σειρά, λαμβάνοντας υπόψη ότι δεν λαμβάνουν έκπτωση
Βασικά σημεία
- Γίνονται δεκτά επτά τερματικά σημεία: δύο για κείμενο, δύο για εικόνες, τρία για βίντεο
- Το Responses είναι το προτεινόμενο τερματικό σημείο· το Chat Completions είναι ένα παρωχημένο τερματικό σημείο στην xAI
- Μόνο τα token σε επιλέξιμα μοντέλα κειμένου λαμβάνουν την έκπτωση 20%
- Το πεδίο
urlκάθε γραμμής JSONL καθορίζει το στόχο τερματικό σημείο και τα τερματικά σημεία μπορούν να αναμειχθούν εντός μιας παρτίδας - Τα αποτελέσματα εικόνων και βίντεο είναι υπογεγραμμένες URLs ισχύουσες για μία ώρα