Rozumienie wideo na platformie X
Na tej stronie
Zaktualizowano 3 listopada 2026 r. Przykład SDK xAI pierwotnie wywoływał metodę
client.responses.create(), która nie istnieje wxai-sdk. W tym SDK przekaż narzędziex_search()do metodyclient.chat.create(). Przykłady dla SDK OpenAI konfigurują teraz klienta tak, aby wskazywał nahttps://api.x.ai/v1. Okres kończy się przed wartościąto_date(wyłącznie), więc okres kwietniowy kończy się dnia2026-05-01. Kontoxaboratorynie istniało; przykład filtruje teraz wyniki dlaxai. Opisy kosztów są zgodne z cennikiem xAI (wizja obrazów i wideo jest liczona jako tokeny obrazowe); usunięto niesprawdzone rankingi liczbowe. Kod zweryfikowano dla wersjixai-sdk1.21.0 orazopenai3.42.1. Źródła: X Search · Cennik.
Analiza wideo publikowanych na platformie X
Wyszukiwarka X oferuje funkcję niedostępną w Wyszukiwarce internetowej: rozumienie wideo. Dzięki parametrowi enable_video_understanding model może analizować treści wideo zawarte w postach na platformie X, które znajdzie podczas wyszukiwania. W połączeniu z rozumieniem obrazów funkcja ta czyni z X Search kompletne narzędzie do analizy multimediów.
Aktywacja
Włącz ją za pomocą parametru enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Możesz jednocześnie włączyć rozumienie obrazów i wideo:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
Składnia SDK
xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # klucz odczytywany ze zmiennej 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("Przeanalizuj najnowsze wideo z prezentacjami produktów AI na platformie X"))
response = chat.sample()
print(response.content)
print(response.citations)
W tym SDK parametry from_date i to_date są obiektami typu datetime, a nie ciągami znaków.
OpenAI SDK (Python)
Poniższe przykłady wykorzystują następującego klienta:
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="Przeanalizuj najnowsze wideo z prezentacjami produktów AI na platformie 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,
}),
},
Przypadki użycia
Monitorowanie premier produktów
Firmy technologiczne często publikują na platformie X wideo z demonstracjami swoich produktów. Dzięki rozumieniu wideo możesz zautomatyzować analizę tych treści:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Jakie nowe funkcje zaprezentowano w wideo przez firmy AI w tym tygodniu?",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"from_date": "2026-10-27",
"to_date": "2026-11-03" # wyłącznie: obejmuje okres do 2 listopada włącznie
}]
)
Analiza tutoriali
Deweloperzy często udostępniają na platformie X krótkie wideo instruktażowe. Rozumienie wideo pozwala wydobyć kluczowe informacje bez konieczności oglądania każdego filmu z osobna.
Monitorowanie kreatywne
Zespoły marketingowe lub projektowe mogą analizować wideo trendujące, kreatywne reklamy lub treści wirusowe publikowane na platformie X.
Pełna kombinacja parametrów
Wyszukiwarka X osiąga pełen potencjał, gdy połączysz wszystkie dostępne parametry:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Podsumuj wideo z demonstracjami opublikowane przez xAI w październiku",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xai"], # bez @, maksymalnie 20 kont
"from_date": "2026-10-01",
"to_date": "2026-11-01", # wyłącznie: cały październik
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
To zapytanie łączy cztery filtry: konkretne konta, przedział czasowy, analizę obrazów oraz analizę wideo.
Wpływ na koszty i wydajność
Zgodnie z cennikiem xAI, narzędzie X Search jest rozliczane na podstawie liczby pobranych postów i profili (5 USD za 1000 postów, 10 USD za 1000 profili), a funkcja wizji dla znalezionych obrazów i wideo dodaje tokeny, liczone jako tokeny obrazowe. Zapytanie otwierające wiele filmów może zatem kosztować znacznie więcej niż wyszukiwanie oparte wyłącznie na tekście. Dyscyplina sprowadza się do trzech kroków. Włącz tę funkcję tylko wtedy, gdy wideo są naprawdę niezbędne do odpowiedzi na pytanie. Zmniejsz zbiór danych na wstępie, stosując filtry kont i dat, które mają zastosowanie do każdego wyszukiwania uruchomionego przez model: mniejsza liczba kandydujących postów oznacza mniej wideo do przeanalizowania. Monitoruj również zużycie zapytań: odpowiedź wskazuje, ile postów i profili zostało pobranych.
Podsumowanie możliwości multimedialnych
| Funkcja | Wyszukiwarka internetowa | X Search |
|---|---|---|
| Tekst | Tak | Tak |
Obrazy (enable_image_understanding) | Tak | Tak |
Wideo (enable_video_understanding) | Nie | Tak |
Rozumienie wideo jest funkcją ekskluzywną dla X Search. Jeśli potrzebujesz analizować wideo znalezione w sieci (poza platformą X), musisz zastosować inne podejścia, takie jak bezpośrednie przesłanie treści wizualnych do modelu.
Kluczowe wnioski
- Rozumienie wideo to funkcja ekskluzywna dla X Search
- Włączasz ją poprzez
enable_video_understanding: true - Można ją łączyć z rozumieniem obrazów, filtrami kont i dat
- Koszt: pobrane posty i profile plus tokeny obrazowe za obejrzone wideo; filtruj według kont i dat
- Idealne rozwiązanie do monitorowania premier, analizy demonstracji i nadzoru nad treściami multimedialnymi