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

Έννοια του Batch API

Μάθημα 1 / 12 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Ασύγχρονη μαζική επεξεργασία
  2. Έκπτωση 20% σε επιλέξιμα μοντέλα
  3. Ροή εργασίας τεσσάρων βημάτων
  4. Υποστηριζόμενα σημεία πρόσβασης (Endpoints)
  5. Πότε να χρησιμοποιήσετε το Batch API
  6. Βασικά σημεία

Ενημερώθηκε στις 2 Νοεμβρίου 2026, βάσει της τεκμηρίωσης της xAI: η έκπτωση batch είναι 20% στα επιλέξιμα μοντέλα κειμένου (όχι 50%), τα παραδείγματα ακολουθούν το REST API και το επίσημο xai-sdk (client.batch.*· το Batch API της xAI δεν χρησιμοποιεί τη μορφή της OpenAI, επομένως το SDK της OpenAI δεν εφαρμόζεται), και το Responses API προηγείται του Chat Completions, το οποίο αποτελεί παρωχημένο σημείο πρόσβασης στην xAI. Πηγές: Batch API · Αναφορά REST · Τιμολόγηση Batch.

Ασύγχρονη μαζική επεξεργασία

Το Batch API της xAI σάς επιτρέπει να στείλετε χιλιάδες αιτήματα σε μία μόνο λειτουργία και στη συνέχεια να ανακτήσετε τα αποτελέσματα μόλις ολοκληρωθεί η επεξεργασία. Σε αντίθεση με τις σύγχρονες κλήσεις, όπου περιμένετε κάθε απάντηση, η λειτουργία batch λειτουργεί ασύγχρονα: υποβάλλετε ένα batch, συνεχίζετε την εργασία σας και επιστρέφετε αργότερα για τα αποτελέσματα.

Αυτή η προσέγγιση καλύπτει μια πραγματική ανάγκη. Όταν χρειάζεται να συνοψίσετε 10.000 άρθρα, να ταξινομήσετε 50.000 εισιτήρια υποστήριξης ή να γράψετε περιγραφές καταλόγου, η αποστολή αιτημάτων ένα προς ένα θα ήταν αργή, δαπανηρή και θα σας οδηγούσε στα όρια ρυθμού (rate limits). Τα αιτήματα batch δεν προσμετρώνται σε αυτά τα όρια.

Έκπτωση 20% σε επιλέξιμα μοντέλα

Το οικονομικό πλεονέκτημα είναι υπαρκτό, αλλά πιο μετριοπαθές από ό,τι υποδηλώνουν ορισμένες πηγές. Η xAI εφαρμόζει έκπτωση 20% στα αιτήματα batch για τα επιλέξιμα μοντέλα κειμένου της—από τις 2 Νοεμβρίου 2026: grok-4.7, grok-4.6, grok-4.5, grok-4.3, και τις τρεις παραλλαγές grok-4.20-0309—σε όλους τους τύπους token: εισόδου, εξόδου, cache και συλλογισμού. Τα μοντέλα που δεν περιλαμβάνονται σε αυτή τη λίστα δεν λαμβάνουν έκπτωση, ακόμη και αν δέχονται batch.

Η δημιουργία εικόνων και βίντεο εκτελείται σε batch, αλλά με την κανονική τιμολόγηση. Δεν δέχονται όλα τα μοντέλα batch: η σελίδα κάθε μοντέλου αναφέρει αν το υποστηρίζει, και ένα αίτημα σε μη επιλέξιμο μοντέλο απορρίπτεται με το μήνυμα not supported for batch processing.

-20%
Tokens για επιλέξιμα μοντέλα
24h
Τυπικός χρόνος παράδοσης, χωρίς εγγύηση
50K
Αιτήματα ανά αρχείο
200 MB
Μέγιστο μέγεθος JSONL

Ροή εργασίας τεσσάρων βημάτων

Το Batch API ακολουθεί ένα απλό και προβλέψιμο μοτίβο:

  1. Δημιουργία ενός ονομασμένου batch με POST /v1/batches
  2. Προσθήκη αιτημάτων, είτε μέσω διαδοχικών κλήσεων είτε όλα μαζί με ένα αρχείο JSONL
  3. Παρακολούθηση της προόδου χρησιμοποιώντας τους μετρητές του batch
  4. Ανάκτηση των αποτελεσμάτων μόλις γίνουν διαθέσιμα ή στο τέλος

Αυτή η ροή εργασίας αποσυνδέει την υποβολή από την επεξεργασία: δεν χρειάζεται να διατηρείτε ανοιχτή μια σύνδεση ενώ το Grok εργάζεται. Τα περισσότερα batch επεξεργάζονται σε λιγότερο από 24 ώρες, αλλά η xAI δεν το εγγυάται: ο χρόνος παράδοσης ποικίλλει ανάλογα με το φορτίο και το μέγεθος του batch.

Υποστηριζόμενα σημεία πρόσβασης (Endpoints)

Το Batch API δεν περιορίζεται στο κείμενο. Ένα μόνο batch μπορεί να αναμειγνύει αιτήματα προς:

  • /v1/responses — το Responses API, με εργαλεία πλευράς διακομιστή (αναζήτηση web, αναζήτηση X, εκτέλεση κώδικα, MCP)
  • /v1/chat/completions — το Chat Completions API, ένα παρωχημένο σημείο πρόσβασης στην xAI
  • /v1/images/generations και /v1/images/edits — δημιουργία και επεξεργασία εικόνων
  • /v1/videos/generations (ή /v1/videos), /v1/videos/edits, και /v1/videos/extensions — δημιουργία, επεξεργασία και επέκταση βίντεο

Για παράδειγμα, μπορείτε να γράψετε περιγραφές προϊόντων και να δημιουργήσετε τις οπτικές τους αναπαραστάσεις στο ίδιο batch.

Πότε να χρησιμοποιήσετε το Batch API

Το Batch API είναι κατάλληλο όταν το αποτέλεσμα μπορεί να περιμένει:

  • Μαζική επεξεργασία δεδομένων: ταξινόμηση, εξαγωγή και σύνοψη χιλιάδων εγγράφων
  • Αξιολογήσεις: εκτέλεση χιλιάδων δοκιμαστικών prompts μέσω ενός μοντέλου
  • Ροές δεδομένων: εμπλουτισμός βάσεων δεδομένων, διαχείριση εκκρεμοτήτων περιεχομένου και προετοιμασία αναφορών κατά τη διάρκεια της νύχτας

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

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

  • Το Batch API επεξεργάζεται αιτήματα ασύγχρονα, τα περισσότερα σε λιγότερο από 24 ώρες, χωρίς εγγύηση
  • Έκπτωση 20% σε όλα τα tokens για επιλέξιμα μοντέλα κειμένου· εικόνες και βίντεο με κανονική τιμολόγηση
  • Η ροή εργασίας έχει τέσσερα βήματα: δημιουργία, προσθήκη, παρακολούθηση, ανάκτηση
  • Κείμενο, εικόνες και βίντεο μπορούν να συνυπάρχουν στο ίδιο batch
  • Τα αιτήματα batch δεν προσμετρώνται στα όρια ρυθμού, αλλά δεν είναι κατάλληλα για πραγματικό χρόνο