Înțelegerea videoclipurilor pe X
Pe această pagină
Actualizat la 3 noiembrie 2026. Exemplul SDK xAI folosea inițial
client.responses.create(), o metodă care nu există înxai-sdk. Cu acest SDK, transmiteți instrumentulx_search()cătreclient.chat.create(). Exemplele SDK OpenAI configurează acum clientul pentru a indica sprehttps://api.x.ai/v1. Perioada se încheie înainte deto_date(exclusiv), astfel încât o perioadă din aprilie se termină la2026-05-01. Contulxaboratorynu exista; exemplul filtrează acum pexai. Descrierile costurilor corespund facturării xAI (viziunea pentru imagini și videoclipuri se numără ca tokeni de imagine); am eliminat clasamentul numeric fără sursă. Codul a fost verificat cuxai-sdk1.21.0 șiopenai3.42.1. Surse: X Search · Prețuri.
Analiza videoclipurilor postate pe X
X Search oferă o funcționalitate exclusivă pe care Web Search nu o are: înțelegerea videoclipurilor. Cu parametrul enable_video_understanding, modelul poate analiza conținutul video din postările de pe X pe care le găsește în timpul căutării. Combinată cu înțelegerea imaginilor, această capacitate transformă X Search într-un instrument complet de analiză multimedia.
Activare
Activați-o prin parametrul enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Puteți activa simultan înțelegerea imaginilor și a videoclipurilor:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
Sintaxa SDK
xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # cheia citită din 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("Analyze the latest AI product video demos on X"))
response = chat.sample()
print(response.content)
print(response.citations)
În acest SDK, from_date și to_date sunt obiecte datetime, nu șiruri de caractere.
OpenAI SDK (Python)
Următoarele exemple utilizează acest 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="Analyze the latest AI product video demos on 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,
}),
},
Cazuri de utilizare
Monitorizarea lansărilor de produse
Companiile tehnologice postează frecvent demo-uri video ale produselor lor pe X. Cu înțelegerea videoclipurilor, puteți automatiza analiza acestui conținut:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What new features were shown in video by AI companies this week?",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"from_date": "2026-10-27",
"to_date": "2026-11-03" # exclusiv: până pe 2 noiembrie inclusiv
}]
)
Analiza tutorialelor
Dezvoltatorii distribuie adesea scurtmetraje tutorial pe X. Înțelegerea videoclipurilor vă permite să extrageți informații cheie fără a fi nevoie să vizionați fiecare filmare.
Monitorizare creativă
Echipele de marketing sau de design pot analiza videoclipuri de tendințe, reclame creative sau conținut viral postat pe X.
Combinarea completă a parametrilor
X Search își atinge potențialul maxim atunci când combinați toți parametrii săi:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Summarize video demos published by xAI in October",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xai"], # fără @, maxim 20 de conturi
"from_date": "2026-10-01",
"to_date": "2026-11-01", # exclusiv: tot luna octombrie
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Această interogare combină patru filtre: conturi specifice, fereastră de timp, analiză de imagine și analiză video.
Impact asupra costurilor și performanței
Conform grilei de prețuri xAI, instrumentul X Search este facturat în funcție de numărul de postări și profiluri recuperate (5 USD per 1.000 de postări, 10 USD per 1.000 de profiluri), iar viziunea pentru imaginile și videoclipurile găsite adaugă tokeni, numărați ca tokeni de imagine. O interogare care deschide multe videoclipuri poate costa, prin urmare, semnificativ mai mult decât o căutare bazată doar pe text. Disciplina se rezumă la trei pași. Activați funcționalitatea doar atunci când videoclipurile sunt cu adevărat esențiale pentru întrebare. Reduceți corpusul în amonte cu filtre de cont și de dată, care se aplică fiecărei căutări lansate de model: mai puține postări candidate înseamnă mai puține videoclipuri de vizionat. Și monitorizați consumul interogărilor: răspunsul indică câte postări și profiluri au fost recuperate.
Rezumatul capacităților multimedia
| Funcționalitate | Web Search | X Search |
|---|---|---|
| Text | Da | Da |
Imagini (enable_image_understanding) | Da | Da |
Video (enable_video_understanding) | Nu | Da |
Înțelegerea videoclipurilor este o exclusivitate X Search. Dacă aveți nevoie să analizați videoclipuri găsite pe web (în afara X), va trebui să utilizați alte abordări, cum ar fi trimiterea conținutului vizual direct către model.
Puncte cheie
- Înțelegerea videoclipurilor este o exclusivitate X Search
- Se activează cu
enable_video_understanding: true - Combinabilă cu înțelegerea imaginilor, handle-urile și datele
- Cost: postări și profiluri recuperate, plus tokeni de imagine pentru videoclipurile vizionate; filtrați după conturi și date
- Ideal pentru monitorizarea lansărilor, analiza demo-urilor și monitorizarea multimedia