Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Videote mõistmine X-is

Õppetund 11 / 16 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. X-i postitatud videote analüüs
  2. Aktiveerimine
  3. SDK süntaks
  4. Kasutusjuhtumid
  5. Parameetrite täiskombinatsioon
  6. Mõju kuludele ja jõudlusele
  7. Multimeediavõimete kokkuvõte
  8. Peamised punktid

Uuendatud 3. novembril 2026. xAI SDK näide kasutas algselt meetodit client.responses.create(), mida xai-sdk ei sisalda. Selle SDK puhul edasta tööriist x_search() meetodile client.chat.create(). OpenAI SDK näited seadistavad nüüd kliendi viitama aadressile https://api.x.ai/v1. Periood lõpeb enne kuupäeva to_date (väljaarvatud), seega lõpeb aprillikuine periood kuupäeval 2026-05-01. Kontot xaboratory ei eksisteerinud; näide filtreerib nüüd konto xai järgi. Kulukirjeldused vastavad xAI arveldusele (piltide ja videote visioon loetakse pilditokeniteks); eemaldati allikata numbriline järjestus. Kood on kontrollitud versioonidega xai-sdk 1.21.0 ja openai 3.42.1. Allikad: X Search · Hinnakiri.

X-i postitatud videote analüüs

X Search pakub eksklusiivset funktsiooni, mida veebiotsingul pole: videote mõistmine. Parameetri enable_video_understanding abil suudab mudel analüüsida videosisu X-i postitustes, mida ta otsingu käigus leiab. Koos piltide mõistmisega muudab see võimalus X Searchi täielikuks multimeediaanalüüsi tööriistaks.

Aktiveerimine

Luba see parameetri enable_video_understanding kaudu:

{
  "tools": [{
    "type": "x_search",
    "enable_video_understanding": true
  }]
}

Saad lubada samaaegselt nii piltide kui ka videote mõistmise:

{
  "tools": [{
    "type": "x_search",
    "enable_image_understanding": true,
    "enable_video_understanding": true
  }]
}

SDK süntaks

xAI SDK (Python)

from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search

client = Client()  # võti loetakse keskkonnamuutujast 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("Analüüsi X-i uusimaid AI-toodete videodemoid"))

response = chat.sample()
print(response.content)
print(response.citations)

Selles SDK-s on from_date ja to_date tüüpi datetime objektid, mitte stringid.

OpenAI SDK (Python)

Järgmised näited kasutavad seda klienti:

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="Analüüsi X-i uusimaid AI-toodete videodemoid",
    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,
  }),
},

Kasutusjuhtumid

Toote lansseerimise jälgimine

Tehnoloogiaettevõtted postitavad X-i sageli oma toodete videodemoid. Videote mõistmise abil saad selle sisu analüüsi automatiseerida:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Milliseid uusi funktsioone näitasid AI-ettevõtted sel nädalal videotes?",
    tools=[{
        "type": "x_search",
        "enable_image_understanding": True,
        "from_date": "2026-10-27",
        "to_date": "2026-11-03"  # välja arvatud: kuni 2. novembrini kaasatud
    }]
)

Õpetuste analüüs

Arendajad jagavad X-is sageli lühikesi videoõpetusi. Videote mõistmine võimaldab sul eraldada võtmeteavet ilma iga videot läbi vaatamata.

Loomuliku sisu jälgimine

Turundus- või disainimeeskonnad saavad analüüsida trendivideoid, loovreklaame või X-i postitatud viirussisu.

Parameetrite täiskombinatsioon

X Search saavutab oma täieliku potentsiaali, kui kombineerid kõiki selle parameetreid:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Tee kokkuvõte xAI poolt oktoobris avaldatud videodemodest",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["xai"],   # ilma @-märgita, maksimaalselt 20 kontot
        "from_date": "2026-10-01",
        "to_date": "2026-11-01",        # välja arvatud: kogu oktoober
        "enable_image_understanding": True,
        "enable_video_understanding": True
    }]
)

See päring ühendab neli filtrit: konkreetsed kontod, ajavahemik, piltide analüüs ja videote analüüs.

Mõju kuludele ja jõudlusele

Vastavalt xAI hinnakirjale arveldatakse X Searchi tööriista leitud postituste ja profiilide arvu järgi (5 dollarit 1000 postituse eest, 10 dollarit 1000 profiili eest) ning leitud piltide ja videote visioon lisab tokeneid, mida loetakse pilditokeniteks. Päring, mis avab palju videoid, võib seetõttu maksta oluliselt rohkem kui ainult tekstipõhine otsing. Distsipliin taandub kolmele sammule. Luba funktsioon ainult siis, kui videod on küsimuse jaoks tõeliselt hädavajalikud. Vähenda algandmestikku konto- ja kuupäevafiltritega, mida rakendatakse igale mudeli käivitatud otsingule: vähem kandidaatpostitusi tähendab vähem vaadatavaid videoid. Ja jälgi päringute tarbimist: vastus näitab, mitu postitust ja profiili leiti.

Multimeediavõimete kokkuvõte

FunktsioonVeebiotsingX Search
TekstJahJah
Pildid (enable_image_understanding)JahJah
Videod (enable_video_understanding)EiJah

Videote mõistmine on X Searchi eksklusiiv. Kui sul on vaja analüüsida veebist (väljaspool X-i) leitud videoid, pead kasutama muid lähenemisviise, näiteks saatma visuaalse sisu otse mudelile.

Peamised punktid

  • Videote mõistmine on X Searchi eksklusiiv
  • Luba käsuga enable_video_understanding: true
  • Kombineeritav piltide mõistmise, kontode ja kuupäevadega
  • Kulud: leitud postitused ja profiilid pluss pilditokenid vaadatud videote eest; filtreeri kontode ja kuupäevade järgi
  • Ideaalne lansseerimise jälgimiseks, demode analüüsiks ja multimeedia jälgimiseks