Comprensione dei video su X
In questa pagina
Aggiornato il 3 novembre 2026. L’esempio originale dell’SDK xAI chiamava
client.responses.create(), un metodo che non esiste inxai-sdk. Con questo SDK, passa lo strumentox_search()aclient.chat.create(). Gli esempi dell’SDK OpenAI configurano ora il client per puntare ahttps://api.x.ai/v1. Il periodo termina prima dito_date(esclusivo), quindi un periodo di aprile termina il2026-05-01. L’accountxaboratorynon esisteva; l’esempio ora filtra suxai. Le descrizioni dei costi corrispondono alla fatturazione xAI (la visione di immagini e video conta come token immagine); rimosso il ranking numerico senza fonti. Codice verificato conxai-sdk1.21.0 eopenai3.42.1. Fonti: Ricerca su X · Prezzi.
Analizzare i video pubblicati su X
La Ricerca su X offre una funzionalità esclusiva che la Ricerca Web non ha: la comprensione dei video. Grazie al parametro enable_video_understanding, il modello può analizzare il contenuto video all’interno dei post su X che trova durante la sua ricerca. Combinata con la comprensione delle immagini, questa capacità rende la Ricerca su X uno strumento completo di analisi multimediale.
Attivazione
Abilitala tramite il parametro enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Puoi abilitare simultaneamente la comprensione delle immagini e dei video:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
Sintassi SDK
xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # chiave letta da 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("Analizza le ultime demo video di prodotti AI su X"))
response = chat.sample()
print(response.content)
print(response.citations)
In questo SDK, from_date e to_date sono oggetti datetime, non stringhe.
OpenAI SDK (Python)
Gli esempi seguenti utilizzano questo client:
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="Analizza le ultime demo video di prodotti AI su 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,
}),
},
Casi d’uso
Monitoraggio del lancio di prodotti
Le aziende tecnologiche pubblicano frequentemente demo video dei loro prodotti su X. Con la comprensione dei video, puoi automatizzare l’analisi di questi contenuti:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Quali nuove funzionalità sono state mostrate nei video dalle aziende AI questa settimana?",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"from_date": "2026-10-27",
"to_date": "2026-11-03" # esclusivo: fino al 2 novembre incluso
}]
)
Analisi di tutorial
Gli sviluppatori condividono spesso brevi video tutorial su X. La comprensione dei video ti permette di estrarre le informazioni chiave senza dover guardare ogni singolo video.
Monitoraggio creativo
I team di marketing o di design possono analizzare video di tendenze, annunci creativi o contenuti virali pubblicati su X.
Combinazione completa dei parametri
La Ricerca su X raggiunge il suo pieno potenziale quando combini tutti i suoi parametri:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Riassumi le demo video pubblicate da xAI a ottobre",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xai"], # senza @, max 20 account
"from_date": "2026-10-01",
"to_date": "2026-11-01", # esclusivo: tutto ottobre
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Questa query combina quattro filtri: account specifici, finestra temporale, analisi delle immagini e analisi dei video.
Impatto su costi e prestazioni
Secondo la griglia dei prezzi di xAI, lo strumento Ricerca su X viene fatturato in base al numero di post e profili recuperati (5 $ per 1.000 post, 10 $ per 1.000 profili), e la visione per le immagini e i video trovati aggiunge token, conteggiati come token immagine. Una query che apre molti video può quindi costare significativamente di più rispetto a una ricerca basata solo sul testo. La disciplina si riduce a tre passaggi. Abilita la funzionalità solo quando i video sono davvero essenziali per la domanda. Riduci il corpus a monte con filtri per account e date, che si applicano a ogni ricerca avviata dal modello: meno post candidati significa meno video da guardare. E monitora il consumo delle query: la risposta indica quanti post e profili sono stati recuperati.
Riepilogo delle capacità multimediali
| Funzionalità | Ricerca Web | Ricerca su X |
|---|---|---|
| Testo | Sì | Sì |
Immagini (enable_image_understanding) | Sì | Sì |
Video (enable_video_understanding) | No | Sì |
La comprensione dei video è un’esclusiva della Ricerca su X. Se hai bisogno di analizzare video trovati sul web (al di fuori di X), dovrai utilizzare altri approcci, come l’invio diretto di contenuti visivi al modello.
Punti chiave
- La comprensione dei video è un’esclusiva della Ricerca su X
- Abilitala con
enable_video_understanding: true - Combinabile con la comprensione delle immagini, gli handle e le date
- Costo: post e profili recuperati, più token immagine per i video guardati; filtra per account e date
- Ideale per il monitoraggio dei lanci, l’analisi delle demo e il monitoraggio multimediale