Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Comprensione dei video su X

Lezione 11 di 16 Aggiornata il 3 novembre 2026 Sviluppatore
In questa pagina
  1. Analizzare i video pubblicati su X
  2. Attivazione
  3. Sintassi SDK
  4. Casi d’uso
  5. Combinazione completa dei parametri
  6. Impatto su costi e prestazioni
  7. Riepilogo delle capacità multimediali
  8. Punti chiave

Aggiornato il 3 novembre 2026. L’esempio originale dell’SDK xAI chiamava client.responses.create(), un metodo che non esiste in xai-sdk. Con questo SDK, passa lo strumento x_search() a client.chat.create(). Gli esempi dell’SDK OpenAI configurano ora il client per puntare a https://api.x.ai/v1. Il periodo termina prima di to_date (esclusivo), quindi un periodo di aprile termina il 2026-05-01. L’account xaboratory non esisteva; l’esempio ora filtra su xai. 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 con xai-sdk 1.21.0 e openai 3.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 WebRicerca su X
TestoSìSì
Immagini (enable_image_understanding)SìSì
Video (enable_video_understanding)NoSì

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