Salt la conținutul principal
Română— Alege o limbă
Meniu

Înțelegerea videoclipurilor pe X

Lecția 11 din 16 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Analiza videoclipurilor postate pe X
  2. Activare
  3. Sintaxa SDK
  4. Cazuri de utilizare
  5. Combinarea completă a parametrilor
  6. Impact asupra costurilor și performanței
  7. Rezumatul capacităților multimedia
  8. Puncte cheie

Actualizat la 3 noiembrie 2026. Exemplul SDK xAI folosea inițial client.responses.create(), o metodă care nu există în xai-sdk. Cu acest SDK, transmiteți instrumentul x_search() către client.chat.create(). Exemplele SDK OpenAI configurează acum clientul pentru a indica spre https://api.x.ai/v1. Perioada se încheie înainte de to_date (exclusiv), astfel încât o perioadă din aprilie se termină la 2026-05-01. Contul xaboratory nu exista; exemplul filtrează acum pe xai. 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 cu xai-sdk 1.21.0 și openai 3.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ționalitateWeb SearchX Search
TextDaDa
Imagini (enable_image_understanding)DaDa
Video (enable_video_understanding)NuDa

Î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