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

Δημιουργία κενής παρτίδας

Μάθημα 4 / 12 Ενημερώθηκε 2 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Πρώτο βήμα: αρχικοποίηση
  2. Η κλήση δημιουργίας
  3. Υλοποίηση σε Python
  4. Υλοποίηση σε JavaScript
  5. Όρια ρυθμού δημιουργίας
  6. Βέλτιστες πρακτικές
  7. Βασικά σημεία

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

Πρώτο βήμα: αρχικοποίηση

Η δημιουργία μιας παρτίδας αποτελεί την πρώτη συγκεκριμένη ενέργεια στη ροή εργασίας σας. Μια κλήση POST /v1/batches αρχικοποιεί έναν κενό περιέκτη ο οποίος θα λάβει στη συνέχεια τα αιτήματά σας. Αυτό το βήμα είναι σκόπιμα λιτό: δημιουργεί το αναγνωριστικό και προετοιμάζει την παρτίδα στην πλευρά του διακομιστή.

1

POST /v1/batches

Δημιουργεί μια ονομασμένη παρτίδα και επιστρέφει το batch_id της.

2

Αποθήκευση του batch_id

Αποθηκεύστε το αναγνωριστικό για μελλοντικές λειτουργίες.

3

Προσθήκη των αιτημάτων

Η παρτίδα είναι έτοιμη να λάβει αιτήματα μέσω του API.

Η κλήση δημιουργίας

Το σώμα του αιτήματος περιέχει μόνο ένα υποχρεωτικό πεδίο, το name:

curl -X POST https://api.x.ai/v1/batches \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "customer_review_analysis"}'

Η απόκριση περιέχει το batch_id, τις ημερομηνίες δημιουργίας και λήξης, καθώς και τους μετρητές της παρτίδας, οι οποίοι είναι ακόμη στο μηδέν (παράδειγμα από την αναφορά API):

{
  "batch_id": "batch_1934e8b5-f3dc-45f1-8329-9841b0aee9d8",
  "name": "customer_review_analysis",
  "create_time": "2025-11-11",
  "expire_time": "2025-11-12",
  "create_api_key_id": "********-****-****-****-************",
  "cancel_time": null,
  "cancel_by_xai_message": null,
  "state": {
    "num_requests": 0,
    "num_pending": 0,
    "num_success": 0,
    "num_error": 0,
    "num_cancelled": 0
  }
}

Υλοποίηση σε Python

Το επίσημο SDK εγκαθίσταται με την εντολή pip install xai-sdk (έκδοση 1.21.0 στις 2 Νοεμβρίου 2026· απαιτείται Python 3.10 τουλάχιστον). Διαβάζει το κλειδί από τη μεταβλητή περιβάλλοντος XAI_API_KEY:

from xai_sdk import Client

client = Client()

batch = client.batch.create(batch_name="customer_review_analysis")
batch_id = batch.batch_id
print(f"Batch created: {batch_id}")

Το επιστρεφόμενο batch_id αποτελεί τη μοναδική αναφορά για την παρτίδα σας. Φυλάξτε το σε μια μεταβλητή, σε αρχείο ή σε βάση δεδομένων, ανάλογα με την αρχιτεκτονική σας.

Υλοποίηση σε JavaScript

Χωρίς SDK, αρκεί ένα απλό fetch προς το REST API:

const response = await fetch("https://api.x.ai/v1/batches", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.XAI_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ name: "customer_review_analysis" })
});

const batch = await response.json();
console.log(`Batch created: ${batch.batch_id}`);

Όρια ρυθμού δημιουργίας

Η δημιουργία παρτίδων περιορίζεται σε 2 ανά δευτερόλεπτο ανά ομάδα· ο αριθμός των παρτίδων δεν έχει ανώτατο όριο. Στην πράξη, σπάνια θα φτάσετε σε αυτό το όριο: συνήθως δημιουργείτε μία παρτίδα ανά λειτουργία και στη συνέχεια προσθέτετε όλα τα αιτήματά σας σε αυτήν. Εάν δημιουργείτε πολλές παρτίδες σε βρόχο, αφήστε τουλάχιστον 500 χιλιοστά του δευτερολέπτου μεταξύ των κλήσεων.

Βέλτιστες πρακτικές

Ονομάστε τις παρτίδες σας προσεκτικά: το όνομα είναι υποχρεωτικό, οπότε κάντε το χρήσιμο. Ένα όνομα που δηλώνει το σύνολο δεδομένων και την ημερομηνία (customer_reviews_2026_11_02) εντοπίζεται εύκολα στη λίστα παρτίδων και στην κονσόλα της xAI, η οποία σας επιτρέπει επίσης να παρακολουθείτε οπτικά τις παρτίδες.

Σημειώστε τη λήξη: το expire_time υποδεικνύει πότε η παρτίδα και τα αποτελέσματά της παύουν να είναι προσβάσιμα. Η διαδικασία ανάκτησής τους πρέπει να εκτελεστεί πριν από εκείνη τη στιγμή.

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

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

  • Η δημιουργία παρτίδας είναι ένα POST /v1/batches του οποίου το μοναδικό υποχρεωτικό πεδίο είναι το name
  • Η απόκριση περιέχει ένα μοναδικό batch_id που πρέπει να διατηρήσετε για το υπόλοιπο της ροής εργασίας
  • Στην Python, το επίσημο SDK xai-sdk εκθέτει τη μέθοδο client.batch.create(batch_name=...)
  • Το όριο είναι 2 δημιουργίες ανά δευτερόλεπτο ανά ομάδα, χωρίς ανώτατο όριο στον αριθμό των παρτίδων
  • Παρακολουθείτε το expire_time και επαναλαμβάνετε μόνο παροδικά σφάλματα