Videoiden ymmärtäminen X:ssä
Tällä sivulla
Päivitetty 3. marraskuuta 2026. xAI SDK -esimerkki käytti aiemmin metodia
client.responses.create(), jota ei ole olemassa kirjastossaxai-sdk. Tällä SDK:lla välitä työkalux_search()funktiolleclient.chat.create(). OpenAI SDK -esimerkit on nyt määritetty osoittamaan osoitteeseenhttps://api.x.ai/v1. Jakso päättyy ennen kohtaato_date(ei mukana), joten huhtikuun jakso päättyy päivämäärään2026-05-01. Tiliäxaboratoryei ole olemassa; esimerkki suodattaa nyt tilinxaiperusteella. Kustannuskuvaukset vastaavat xAI:n laskutusta (kuvien ja videoiden visio lasketaan kuvatokeneiksi); perusteeton numeerinen sijoitus on poistettu. Koodi on varmistettu versioillaxai-sdk1.21.0 jaopenai3.42.1. Lähteet: X Search · Hinnoittelu.
Analysoi X:ään lähetettyjä videoita
X Search tarjoaa ainutlaatuisen ominaisuuden, jota Web Search ei sisällä: videoiden ymmärtämisen. Parametrin enable_video_understanding avulla malli voi analysoida videosisältöä X-julkaisuissa, jotka se löytää haun aikana. Yhdistettynä kuvien ymmärtämiseen tämä tekee X Searchistä täydellisen multimedianalyysityökalun.
Aktivointi
Ota ominaisuus käyttöön parametrilla enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Voit ottaa kuvien ja videoiden ymmärtämisen käyttöön samanaikaisesti:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
SDK-syntaksi
xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # avain luetaan ympäristömuuttujasta 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)
Tässä SDK:ssa from_date ja to_date ovat datetime-olioita, eivät merkkijonoja.
OpenAI SDK (Python)
Seuraavat esimerkit käyttävät tätä asiakasohjelmaa:
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,
}),
},
Käyttötapaukset
Tuotelanseerausten seuranta
Teknologiayritykset julkaisevat usein tuotteidensa videodemioita X:ssä. Videoiden ymmärtämisen avulla voit automatisoida tämän sisällön analyysin:
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" # ei mukana: sisältää 2. marraskuuta asti
}]
)
Oppituntien analyysi
Kehittäjät jakavat usein lyhyitä video-oppaita X:ssä. Videoiden ymmärtäminen mahdollistaa keskeisten tietojen poimimisen ilman, että sinun tarvitsee katsoa jokaista videota.
Luovan sisällön seuranta
Markkinointi- tai suunnittelutiimit voivat analysoida trendivideoita, luovia mainoksia tai X:ssä julkaistua viraalia sisältöä.
Kaikkien parametrien yhdistäminen
X Search saavuttaa täyden potentiaalinsa, kun yhdistät kaikki sen parametrit:
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"], # ilman @-merkkiä, enintään 20 tiliä
"from_date": "2026-10-01",
"to_date": "2026-11-01", # ei mukana: koko lokakuu
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Tämä kysely yhdistää neljä suodatinta: tietyt tilit, aikavälin, kuvien analyysin ja videoiden analyysin.
Vaikutus kustannuksiin ja suorituskykyyn
xAI:n hinnoittelutaulukon mukaan X Search -työkalusta veloitetaan haettujen julkaisujen ja profiilien määrän perusteella (5 dollaria per 1 000 julkaisua, 10 dollaria per 1 000 profiilia). Löydettyjen kuvien ja videoiden visio lisää token-kulutusta, joka lasketaan kuvatokeneiksi. Kysely, joka avaa paljon videoita, voi siis maksaa huomattavasti enemmän kuin pelkkään tekstiin perustuva haku. Kurinalaisuus tiivistyy kolmeen vaiheeseen. Ota ominaisuus käyttöön vain, kun videot ovat kysymyksen kannalta todella olennaisia. Pienennä sisältömassaa etukäteen tili- ja päivämääräsuodattimilla, jotka koskevat jokaista mallin suorittamaa hakua: vähemmän ehdokasjulkaisuja tarkoittaa vähemmän katsottavia videoita. Seuraa kyselyjen kulutusta: vastaus ilmoittaa, kuinka monta julkaisua ja profiilia haettiin.
Multimediakykyjen yhteenveto
| Ominaisuus | Web Search | X Search |
|---|---|---|
| Teksti | Kyllä | Kyllä |
Kuvat (enable_image_understanding) | Kyllä | Kyllä |
Videot (enable_video_understanding) | Ei | Kyllä |
Videoiden ymmärtäminen on X Searchin yksinoikeus. Jos tarvitset verkosta (X:n ulkopuolelta) löytyneiden videoiden analysointia, sinun on käytettävä muita lähestymistapoja, kuten visuaalisen sisällön lähettämistä suoraan mallille.
Keskeiset asiat
- Videoiden ymmärtäminen on X Searchin yksinoikeus
- Ota käyttöön asetuksella
enable_video_understanding: true - Yhdistettävissä kuvien ymmärtämiseen, tileihin ja päivämääriin
- Kustannukset: haetut julkaisut ja profiilit sekä katsottujen videoiden kuvatokenit; suodata tilien ja päivämäärien perusteella
- Ihanteellinen tuotelanseerausten seurantaan, demojen analyysiin ja multimedian seurantaan