Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Videoiden ymmärtäminen X:ssä

Oppitunti 11 / 16 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Analysoi X:ään lähetettyjä videoita
  2. Aktivointi
  3. SDK-syntaksi
  4. Käyttötapaukset
  5. Kaikkien parametrien yhdistäminen
  6. Vaikutus kustannuksiin ja suorituskykyyn
  7. Multimediakykyjen yhteenveto
  8. Keskeiset asiat

Päivitetty 3. marraskuuta 2026. xAI SDK -esimerkki käytti aiemmin metodia client.responses.create(), jota ei ole olemassa kirjastossa xai-sdk. Tällä SDK:lla välitä työkalu x_search() funktiolle client.chat.create(). OpenAI SDK -esimerkit on nyt määritetty osoittamaan osoitteeseen https://api.x.ai/v1. Jakso päättyy ennen kohtaa to_date (ei mukana), joten huhtikuun jakso päättyy päivämäärään 2026-05-01. Tiliä xaboratory ei ole olemassa; esimerkki suodattaa nyt tilin xai perusteella. Kustannuskuvaukset vastaavat xAI:n laskutusta (kuvien ja videoiden visio lasketaan kuvatokeneiksi); perusteeton numeerinen sijoitus on poistettu. Koodi on varmistettu versioilla xai-sdk 1.21.0 ja openai 3.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

OminaisuusWeb SearchX Search
TekstiKylläKyllä
Kuvat (enable_image_understanding)KylläKyllä
Videot (enable_video_understanding)EiKyllä

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