Vaizdo įrašų supratimas X platformoje
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d. xAI SDK pavyzdyje iš pradžių buvo naudojamas metodas
client.responses.create(), kurioxai-sdkbibliotekoje nėra. Naudojant šį SDK, perduokite įrankįx_search()funkcijaiclient.chat.create(). OpenAI SDK pavyzdžiai dabar sukonfigūruoja klientą nukreipti užklausas įhttps://api.x.ai/v1. Laikotarpis baigiasi priešto_date(neįskaitant), todėl balandžio mėnesio laikotarpis baigiasi2026-05-01. Paskyraxaboratoryneegzistavo; pavyzdyje dabar filtruojama pagalxai. Išlaidų aprašymai atitinka xAI kainodarą (vaizdų ir vaizdo įrašų vizija skaičiuojama kaip vaizdo žetonai); pašalintas nepagrįstas skaitinis reitingavimas. Kodas patikrintas suxai-sdk1.21.0 iropenai3.42.1. Šaltiniai: X Search · Kainodara.
Analizuok X platformoje paskelbtus vaizdo įrašus
„X Search“ siūlo išskirtinę funkciją, kurios „Web Search“ neturi: vaizdo įrašų supratimą. Naudodamas parametrą enable_video_understanding, modelis gali analizuoti vaizdo įrašų turinį X įrašuose, kuriuos randamas paieškos metu. Derinant tai su vaizdų supratimu, ši galimybė paverčia „X Search“ pilnaverte daugialypės terpės analizės priemone.
Aktyvavimas
Įjunkite šią funkciją naudodami parametrą enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Vaizdų ir vaizdo įrašų supratimą galite įjungti vienu metu:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
SDK sintaksė
xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # raktas nuskaitytas iš 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)
Šiame SDK from_date ir to_date yra datetime objektai, o ne eilučių reikšmės.
OpenAI SDK (Python)
Šiuose pavyzdžiuose naudojamas šis klientas:
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,
}),
},
Naudojimo atvejai
Produktų paleidimo stebėjimas
Technologijų įmonės dažnai skelbia savo produktų vaizdo demonstracijas X platformoje. Naudodami vaizdo įrašų supratimą, galite automatizuoti šio turinio analizę:
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" # exclusive: through November 2 inclusive
}]
)
Mokomųjų vaizdo įrašų analizė
Kūrėjai dažnai dalijasi trumpais mokomaisiais vaizdo įrašais X platformoje. Vaizdo įrašų supratimas leidžia išgauti pagrindinę informaciją nežiūrint kiekvieno vaizdo įrašo.
Kūrybinis stebėjimas
Rinkodaros ar dizaino komandos gali analizuoti tendencijų vaizdo įrašus, kūrybines reklamas ar viralinį turinį, paskelbtą X platformoje.
Visas parametrų derinys
„X Search“ visiškai atsiskleidžia, kai derinate visus jo parametrus:
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"], # without @, max 20 accounts
"from_date": "2026-10-01",
"to_date": "2026-11-01", # exclusive: all of October
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Ši užklausa sujungia keturis filtrus: konkrečias paskyras, laiko langą, vaizdų analizę ir vaizdo įrašų analizę.
Išlaidų ir našumo poveikis
Pagal xAI kainodaros lentelę, „X Search“ įrankis apmokestinamas pagal gautų įrašų ir profilių skaičių (5 USD už 1 000 įrašų, 10 USD už 1 000 profilių), o rastų vaizdų ir vaizdo įrašų vizija prideda žetonų, skaičiuojamų kaip vaizdo žetonai. Užklausa, atidaranti daug vaizdo įrašų, todėl gali kainuoti žymiai daugiau nei tik teksto paieška. Disciplina susideda iš trijų žingsnių. Įjunkite funkciją tik tada, kai vaizdo įrašai yra tikrai būtini atsakant į klausimą. Sumažinkite duomenų bazę iš anksto naudodami paskyrų ir datų filtrus, kurie taikomi kiekvienai modelio vykdomai paieškai: mažiau kandidatų įrašų reiškia mažiau vaizdo įrašų peržiūrai. Ir stebėkite užklausų vartojimą: atsakyme nurodoma, kiek įrašų ir profilių buvo gauta.
Daugialypės terpės galimybių santrauka
| Funkcija | Web Search | X Search |
|---|---|---|
| Tekstas | Taip | Taip |
Vaizdai (enable_image_understanding) | Taip | Taip |
Vaizdo įrašai (enable_video_understanding) | Ne | Taip |
Vaizdo įrašų supratimas yra išskirtinė „X Search“ funkcija. Jei reikia analizuoti internete (už X ribų) rastus vaizdo įrašus, turėsite naudoti kitus metodus, pavyzdžiui, siųsti vizualinį turinį tiesiai modeliui.
Svarbiausi punktai
- Vaizdo įrašų supratimas yra išskirtinė „X Search“ funkcija
- Įjunkite naudodami
enable_video_understanding: true - Galima derinti su vaizdų supratimu, paskyrų vardais ir datomis
- Kaina: gauti įrašai ir profiliai plius vaizdo žetonai už peržiūrėtus vaizdo įrašus; filtruokite pagal paskyras ir datas
- Idealu produktų paleidimo stebėjimui, demonstracijų analizei ir daugialypės terpės monitoringui