Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Vaizdo įrašų supratimas X platformoje

Paskaita 11 iš 16 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Analizuok X platformoje paskelbtus vaizdo įrašus
  2. Aktyvavimas
  3. SDK sintaksė
  4. Naudojimo atvejai
  5. Visas parametrų derinys
  6. Išlaidų ir našumo poveikis
  7. Daugialypės terpės galimybių santrauka
  8. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d. xAI SDK pavyzdyje iš pradžių buvo naudojamas metodas client.responses.create(), kurio xai-sdk bibliotekoje nėra. Naudojant šį SDK, perduokite įrankį x_search() funkcijai client.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 baigiasi 2026-05-01. Paskyra xaboratory neegzistavo; pavyzdyje dabar filtruojama pagal xai. 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 su xai-sdk 1.21.0 ir openai 3.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

FunkcijaWeb SearchX Search
TekstasTaipTaip
Vaizdai (enable_image_understanding)TaipTaip
Vaizdo įrašai (enable_video_understanding)NeTaip

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