Εικόνες και Βίντεο σε Παρτίδες
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 2 Νοεμβρίου 2026 βάσει της τεκμηρίωσης της xAI: η έκπτωση παρτίδας είναι 20% στα επιλέξιμα μοντέλα κειμένου (όχι 50%), τα παραδείγματα ακολουθούν το REST API και το επίσημο
xai-sdk(client.batch.*· το Batch API της xAI δεν χρησιμοποιεί τη μορφή OpenAI, οπότε το SDK της OpenAI δεν εφαρμόζεται), και το Responses API έχει προτεραιότητα έναντι του Chat Completions, το οποίο αποτελεί παρωχημένο endpoint στην xAI. Πηγές: Batch API · REST Reference · Batch Pricing.
Μαζική Δημιουργία Πολυτροπικού Περιεχομένου
Το Batch API δεν περιορίζεται στο κείμενο. Μπορείτε να υποβάλετε αιτήματα για δημιουργία και επεξεργασία εικόνων, καθώς και για δημιουργία, επεξεργασία και επέκταση βίντεο. Αυτή η δυνατότητα ανοίγει τον δρόμο για πλήρεις πολυτροπικές ροές εργασίας: συγγραφή περιγραφών και παραγωγή των αντίστοιχων οπτικών στοιχείων σε μία μόνο ενέργεια.
Δημιουργία Εικόνων σε Παρτίδα
Το endpoint /v1/images/generations λειτουργεί σε παρτίδα ακριβώς όπως και στον σύγχρονο τρόπο λειτουργίας. Επιλέγετε τη μορφή με το aspect_ratio, τον ορισμό με το resolution ("1k", "1.5k" ή "2k") και τον αριθμό των εικόνων με το n:
{"custom_id": "img-001", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Minimalist logo for a fintech startup, white background, vector style", "n": 1, "aspect_ratio": "1:1", "resolution": "1k"}}
{"custom_id": "img-002", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Isometric illustration of a datacenter", "n": 1, "aspect_ratio": "16:9", "resolution": "1k"}}
Επεξεργασία Εικόνων σε Παρτίδα
Το endpoint /v1/images/edits τροποποιεί μια υπάρχουσα εικόνα, η οποία περνάει μέσα σε ένα αντικείμενο image: είτε ως url (δημόσια διεύθυνση ή δεδομένα κωδικοποιημένα σε base64) είτε ως file_id ενός μεταφορτωμένου αρχείου.
{"custom_id": "edit-001", "method": "POST", "url": "/v1/images/edits", "body": {"model": "grok-imagine-image-2.0", "prompt": "Replace the background with a solid white background", "image": {"url": "https://example.com/photo.jpg"}}}
Σε λειτουργία παρτίδας, η επεξεργασία βοηθά στην επεξεργασία καταλόγων: εναρμόνιση φόντων, προσθήκη στοιχείου ή εφαρμογή της ίδιας διόρθωσης σε εκατοντάδες οπτικά αρχεία.
Δημιουργία Βίντεο σε Παρτίδα
Το endpoint /v1/videos/generations (ή /v1/videos) δημιουργεί βίντεο διάρκειας 1 έως 15 δευτερολέπτων (duration, προεπιλογή 8), σε ανάλυση 480p, 720p ή 1080p:
{"custom_id": "vid-001", "method": "POST", "url": "/v1/videos/generations", "body": {"model": "grok-imagine-video-1.5", "prompt": "Smooth animation of a bar chart growing progressively", "duration": 8, "resolution": "720p"}}
Η επεξεργασία βίντεο είναι πιο απαιτητική σε πόρους από το κείμενο ή τις εικόνες, επομένως αυτά τα αιτήματα ενδέχεται να χρειαστούν περισσότερο χρόνο εντός της παρτίδας.
Επεξεργασία και Επέκταση Βίντεο
Το endpoint /v1/videos/edits τροποποιεί ένα υπάρχον βίντεο, ενώ το /v1/videos/extensions το επεκτείνει προσθέτοντας ένα τμήμα 2 έως 10 δευτερολέπτων. Περάστε το βίντεο προέλευσης σε ένα αντικείμενο video (URL αρχείου .mp4 ή file_id):
{"custom_id": "vid-edit-001", "method": "POST", "url": "/v1/videos/edits", "body": {"model": "grok-imagine-video", "prompt": "Slow down the scene", "video": {"url": "https://example.com/clip.mp4"}}}
{"custom_id": "vid-ext-001", "method": "POST", "url": "/v1/videos/extensions", "body": {"model": "grok-imagine-video", "prompt": "The camera slowly pulls back and reveals a sunset", "video": {"url": "https://example.com/clip.mp4"}, "duration": 6}}
Χρήση του Python SDK
Το SDK προετοιμάζει αυτά τα αιτήματα με εξειδικευμένες μεθόδους και στη συνέχεια τα προσθέτει στην παρτίδα όπως τα αιτήματα κειμένου:
from xai_sdk import Client
client = Client()
batch = client.batch.create(batch_name="catalog_visuals")
requetes = [
client.image.prepare(
prompt="Product shot of wireless headphones, dark background, studio lighting",
model="grok-imagine-image-2.0",
batch_request_id="prod-42-img",
),
client.video.prepare(
prompt="The headphones rotate slowly on a turntable, dramatic lighting",
model="grok-imagine-video-1.5",
batch_request_id="prod-42-vid",
),
]
client.batch.add(batch_id=batch.batch_id, batch_requests=requetes)
Τιμολόγηση Πολυτροπικού Περιεχομένου
Σημαντικό σημείο: η έκπτωση παρτίδας ισχύει μόνο για επιλέξιμα μοντέλα κειμένου. Οι εικόνες και τα βίντεο χρεώνονται με την τυπική τιμή, ακόμη και σε λειτουργία παρτίδας—από τις 2 Νοεμβρίου 2026, $0.04 ανά εικόνα με το grok-imagine-image-2.0 ($0.02 με το grok-imagine-image) και $0.08 ανά δευτερόλεπτο βίντεο με το grok-imagine-video-1.5 ($0.02 στην έκδοση -lite, $0.05 με το grok-imagine-video).
Το όφελος των παρτίδων για πολυτροπικό περιεχόμενο δεν είναι οικονομικό, αλλά λειτουργικό: υποβάλλετε εκατοντάδες δημιουργίες σε μία μόνο ενέργεια, χωρίς να διαχειρίζεστε τόσα πολλά calls ή να χτυπάτε όρια ρυθμού (rate limits).
Λήξη URL Αποτελεσμάτων
Τα αποτελέσματα εικόνων και βίντεο παρέχονται ως υπογεγραμμένα URLs που λήγουν μετά από μία ώρα. Αυτός είναι ένας κρίσιμος περιορισμός: κατεβάστε τα αρχεία μόλις ανακτήσετε τα αποτελέσματα.
import mimetypes
import requests
def telecharger_medias(resultats, dossier):
"""Downloads images and videos as soon as results are retrieved."""
for r in resultats:
reponse = r.proto.response
if reponse.HasField("image_response"):
url = r.image_response.url
elif reponse.HasField("video_response"):
url = r.video_response.url
else:
continue # text result
fichier = requests.get(url, timeout=120)
fichier.raise_for_status()
type_mime = fichier.headers.get("Content-Type", "").split(";")[0]
extension = mimetypes.guess_extension(type_mime) or ".bin"
with open(f"{dossier}/{r.batch_request_id}{extension}", "wb") as f:
f.write(fichier.content)
Μην αποθηκεύετε ποτέ υπογεγραμμένα URLs για μετέπειτα χρήση: αποθηκεύστε τα αρχεία στον δικό σας χώρο αποθήκευσης (S3, GCS, τοπικός δίσκος).
Μικτή Πολυτροπική Ροή Εργασίας
Μια συγκεκριμένη περίπτωση χρήσης: παραγωγή πλήρων δελτίων προϊόντων, κειμένου και οπτικού υλικού, στην ίδια παρτίδα:
{"custom_id": "prod-42-desc", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": "Write a marketing description for a high-end wireless headphone.", "max_output_tokens": 300}}
{"custom_id": "prod-42-img", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Product shot of premium wireless headphones, dark gradient background, studio lighting"}}
Ένα κοινό πρόθεμα στα αναγνωριστικά (prod-42-desc, prod-42-img) διευκολύνει την ομαδοποίηση των αποτελεσμάτων κειμένου και εικόνας για το ίδιο προϊόν.
Βασικά σημεία
- Οι εικόνες (δημιουργία, επεξεργασία) και τα βίντεο (δημιουργία, επεξεργασία, επέκταση) λειτουργούν σε παρτίδες
- Οι παράμετροι αντιστοιχούν στο API:
aspect_ratio,resolution, αντικείμεναimageκαιvideo - Οι εικόνες και τα βίντεο παραμένουν στις τυπικές τιμές, χωρίς εκπτώσεις παρτίδας
- Τα υπογεγραμμένα URL αποτελεσμάτων λήγουν μετά από μία ώρα: κατεβάστε τα άμεσα
- Ένα κοινό πρόθεμα στα αναγνωριστικά ομαδοποιεί τα αποτελέσματα για το ίδιο προϊόν