Κατανόηση βίντεο στο X
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026. Το παράδειγμα xAI SDK αρχικά καλούσε τη μέθοδο
client.responses.create(), η οποία δεν υπάρχει στοxai-sdk. Με αυτό το SDK, περάστε το εργαλείοx_search()στη μέθοδοclient.chat.create(). Τα παραδείγματα του OpenAI SDK διαμορφώνουν πλέον τον πελάτη ώστε να δείχνει στοhttps://api.x.ai/v1. Η περίοδος λήγει πριν από την τιμήto_date(αποκλειστικά), οπότε μια περίοδος του Απριλίου λήγει στις2026-05-01. Ο λογαριασμόςxaboratoryδεν υπήρχε· το παράδειγμα πλέον φιλτράρει με βάση τοxai. Οι περιγραφές κόστους ευθυγραμμίζονται με τη χρέωση της xAI (η όραση εικόνων και βίντεο μετρά ως tokens εικόνας)· αφαιρέθηκε η μη τεκμηριωμένη αριθμητική κατάταξη. Ο κώδικας επαληθεύτηκε με τις εκδόσειςxai-sdk1.21.0 καιopenai3.42.1. Πηγές: X Search · Τιμολόγηση.
Ανάλυση βίντεο που αναρτώνται στο X
Το X Search προσφέρει μια αποκλειστική λειτουργία που δεν διαθέτει το Web Search: την κατανόηση βίντεο. Μέσω της παραμέτρου enable_video_understanding, το μοντέλο μπορεί να αναλύσει το περιεχόμενο βίντεο εντός των αναρτήσεων στο X που εντοπίζει κατά την αναζήτησή του. Σε συνδυασμό με την κατανόηση εικόνων, αυτή η δυνατότητα καθιστά το X Search ένα ολοκληρωμένο εργαλείο ανάλυσης πολυμέσων.
Ενεργοποίηση
Ενεργοποιήστε το μέσω της παραμέτρου enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Μπορείτε να ενεργοποιήσετε ταυτόχρονα την κατανόηση εικόνων και βίντεο:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
Σύνταξη SDK
xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # το κλειδί διαβάζεται από το XAI_API_KEY
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[x_search(enable_image_understanding=True, enable_video_understanding=True)],
)
chat.append(user("Ανάλυσε τις πιο πρόσφατες βιντεοπαρουσιάσεις προϊόντων AI στο X"))
response = chat.sample()
print(response.content)
print(response.citations)
Σε αυτό το SDK, τα from_date και to_date είναι αντικείμενα datetime, όχι συμβολοσειρές.
OpenAI SDK (Python)
Τα παρακάτω παραδείγματα χρησιμοποιούν αυτόν τον πελάτη:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Ανάλυσε τις πιο πρόσφατες βιντεοπαρουσιάσεις προϊόντων AI στο X",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Vercel AI SDK (JavaScript)
tools: {
x_search: xai.tools.xSearch({
enableImageUnderstanding: true,
enableVideoUnderstanding: true,
}),
},
Περιπτώσεις χρήσης
Παρακολούθηση κυκλοφορίας προϊόντων
Οι τεχνολογικές εταιρείες αναρτούν συχνά βιντεοπαρουσιάσεις των προϊόντων τους στο X. Με την κατανόηση βίντεο, μπορείτε να αυτοματοποιήσετε την ανάλυση αυτού του περιεχομένου:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Ποια νέα χαρακτηριστικά παρουσιάστηκαν σε βίντεο από εταιρείες AI αυτή την εβδομάδα;",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"from_date": "2026-10-27",
"to_date": "2026-11-03" # αποκλειστικά: έως και τις 2 Νοεμβρίου
}]
)
Ανάλυση εκπαιδευτικών οδηγιών
Οι προγραμματιστές συχνά κοινοποιούν σύντομα βίντεο-οδηγούς στο X. Η κατανόηση βίντεο σάς επιτρέπει να εξάγετε βασικές πληροφορίες χωρίς να χρειάζεται να παρακολουθήσετε κάθε βίντεο.
Δημιουργική παρακολούθηση
Οι ομάδες μάρκετινγκ ή σχεδιασμού μπορούν να αναλύσουν βίντεο με τάσεις, δημιουργικές διαφημίσεις ή ιικό περιεχόμενο που αναρτάται στο X.
Πλήρης συνδυασμός παραμέτρων
Το X Search αποδίδει στο έπακρο όταν συνδυάζετε όλες τις παραμέτρους του:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Συνοψίστε τις βιντεοπαρουσιάσεις που δημοσίευσε η xAI τον Οκτώβριο",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xai"], # χωρίς @, μέγιστο 20 λογαριασμοί
"from_date": "2026-10-01",
"to_date": "2026-11-01", # αποκλειστικά: όλος ο Οκτώβριος
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Αυτό το ερώτημα συνδυάζει τέσσερα φίλτρα: συγκεκριμένους λογαριασμούς, χρονικό παράθυρο, ανάλυση εικόνων και ανάλυση βίντεο.
Επίπτωση στο κόστος και την απόδοση
Σύμφωνα με τον τιμοκατάλογο της xAI, το εργαλείο X Search χρεώνεται με βάση τον αριθμό των αναρτήσεων και των προφίλ που ανακτώνται (5 $ ανά 1.000 αναρτήσεις, 10 $ ανά 1.000 προφίλ), ενώ η όραση για τις εικόνες και τα βίντεο που εντοπίζονται προσθέτει tokens, τα οποία μετρώνται ως tokens εικόνας. Ένα ερώτημα που ανοίγει πολλά βίντεο μπορεί επομένως να κοστίζει σημαντικά περισσότερο από μια αναζήτηση μόνο κειμένου. Η πειθαρχία συνοψίζεται σε τρία βήματα. Ενεργοποιήστε τη λειτουργία μόνο όταν τα βίντεο είναι πραγματικά απαραίτητα για το ερώτημα. Μειώστε το σώμα δεδομένων εκ των προτέρων με φίλτρα λογαριασμών και ημερομηνιών, τα οποία ισχύουν για κάθε αναζήτηση που εκτελεί το μοντέλο: λιγότερες υποψήφιες αναρτήσεις σημαίνουν λιγότερα βίντεο προς παρακολούθηση. Και παρακολουθείτε την κατανάλωση των ερωτημάτων: η απόκριση υποδεικνύει πόσες αναρτήσεις και προφίλ ανακτήθηκαν.
Σύνοψη δυνατοτήτων πολυμέσων
| Λειτουργία | Web Search | X Search |
|---|---|---|
| Κείμενο | Ναι | Ναι |
Εικόνες (enable_image_understanding) | Ναι | Ναι |
Βίντεο (enable_video_understanding) | Όχι | Ναι |
Η κατανόηση βίντεο είναι αποκλειστικότητα του X Search. Εάν χρειάζεται να αναλύσετε βίντεο που βρίσκονται στον ιστό (εκτός X), θα πρέπει να χρησιμοποιήσετε άλλες προσεγγίσεις, όπως η απευθείας αποστολή οπτικού περιεχομένου στο μοντέλο.
Βασικά σημεία
- Η κατανόηση βίντεο είναι αποκλειστικότητα του X Search
- Ενεργοποιείται με
enable_video_understanding: true - Συνδυάζεται με κατανόηση εικόνων, χειρισμούς (handles) και ημερομηνίες
- Κόστος: ανακτημένες αναρτήσεις και προφίλ, συν tokens εικόνας για τα βίντεο που παρακολουθήθηκαν· φιλτράρισμα κατά λογαριασμό και ημερομηνία
- Ιδανικό για παρακολούθηση κυκλοφορίας προϊόντων, ανάλυση επιδείξεων και παρακολούθηση πολυμέσων