Video-Verständnis auf X
Auf dieser Seite
Aktualisiert am 3. November 2026. Das ursprüngliche Beispiel für das xAI-SDK rief
client.responses.create()auf, eine Methode, die imxai-sdknicht existiert. Mit diesem SDK übergeben Sie das Werkzeugx_search()anclient.chat.create(). Beispiele für das OpenAI SDK konfigurieren den Client nun so, dass er aufhttps://api.x.ai/v1. zeigt. Der Punkt endet vorto_date(ausschließlich), sodass ein Zeitraum im April am2026-05-01endet. Das Kontoxaboratoryexistierte nicht; das Beispiel filtert nun nachxai. Die Kostenbeschreibungen entsprechen der xAI-Rechnung (Bild- und Videoverstehen werden als Bild-Token gezählt); die nicht belegte numerische Rangfolge wurde entfernt. Der Code wurde mitxai-sdk1.21.0 undopenai3.42.1 verifiziert. Quellen: X-Suche · Preise.
Analyse von auf X veröffentlichten Videos
Die X-Suche bietet eine exklusive Funktion, die die Websuche nicht hat: Video-Verständnis. Mit dem Parameter enable_video_understanding kann das Modell Videoinhalte analysieren, die es in X-Beiträgen findet, die es während seiner Suche aufspürt. In Kombination mit Bildverständnis macht diese Fähigkeit die X-Suche zu einem vollständigen Multimedia-Analysewerkzeug.
Aktivierung
Aktivieren Sie es über den Parameter enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Sie können Bild- und Video-Verständnis gleichzeitig aktivieren:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
SDK-Syntax
xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # Schlüssel wird aus XAI_API_KEY gelesen
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[x_search(enable_image_understanding=True, enable_video_understanding=True)],
)
chat.append(user("Analysieren Sie die neuesten Videodemos von KI-Produkten auf X"))
response = chat.sample()
print(response.content)
print(response.citations)
In diesem SDK sind from_date und to_date datetime-Objekte, keine Zeichenketten.
OpenAI SDK (Python)
Die folgenden Beispiele verwenden diesen Client:
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="Analysieren Sie die neuesten Videodemos von KI-Produkten auf 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,
}),
},
Anwendungsfälle
Überwachung von Produktlaunches
Tech-Unternehmen veröffentlichen häufig Videodemos ihrer Produkte auf X. Mit Video-Verständnis können Sie die Analyse dieses Inhalts automatisieren:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Welche neuen Funktionen wurden in Videos von KI-Unternehmen diese Woche gezeigt?",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"from_date": "2026-10-27",
"to_date": "2026-11-03" # ausschließlich: bis einschließlich November 2
}]
)
Analyse von Tutorials
Entwickler teilen oft kurze Videotutorials auf X. Video-Verständnis ermöglicht es Ihnen, Schlüsselinformationen zu extrahieren, ohne jedes Video anzusehen.
Überwachung kreativer Inhalte
Marketing- oder Design-Teams können Trendvideos, kreative Werbung oder virale Inhalte, die auf X veröffentlicht wurden, analysieren.
Vollständige Parameterkombination
Die X-Suche entfaltet ihr volles Potenzial, wenn Sie alle ihre Parameter kombinieren:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Fassen Sie Videodemos zusammen, die von xAI im Oktober veröffentlicht wurden",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xai"], # ohne @, maximal 20 Konten
"from_date": "2026-10-01",
"to_date": "2026-11-01", # ausschließlich: der gesamte Oktober
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Diese Abfrage kombiniert vier Filter: spezifische Konten, Zeitfenster, Bildanalyse und Videoanalyse.
Auswirkungen auf Kosten und Leistung
Laut dem Preisgitter von xAI wird das Werkzeug X-Suche pro Anzahl der abgerufenen Beiträge und Profile berechnet (5 USD pro 1.000 Beiträge, 10 USD pro 1.000 Profile), und Vision für gefundene Bilder und Videos fügt Token hinzu, die als Bild-Token gezählt werden. Eine Abfrage, die viele Videos öffnet, kann daher erheblich teurer sein als eine textbasierte Suche. Disziplin reduziert sich auf drei Schritte. Aktivieren Sie die Funktion nur, wenn Videos für die Frage wirklich unerlässlich sind. Reduzieren Sie den Korpus upstream durch Konten- und Datumsfilter, die auf jede vom Modell gestartete Suche anwendbar sind: Weniger Kandidatenbeiträge bedeuten weniger Videos zum Anschauen. Und überwachen Sie den Abfrageverbrauch: Die Antwort gibt an, wie viele Beiträge und Profile abgerufen wurden.
Zusammenfassung der Multimedia-Fähigkeiten
| Funktion | Websuche | X-Suche |
|---|---|---|
| Text | Ja | Ja |
Bilder (enable_image_understanding) | Ja | Ja |
Video (enable_video_understanding) | Nein | Ja |
Video-Verständnis ist exklusiv für die X-Suche. Wenn Sie Videos analysieren müssen, die im Web gefunden wurden (außerhalb von X), müssen Sie andere Ansätze verwenden, wie z. B. das direkte Senden von visuellen Inhalten an das Modell.
Kernaussagen
- Video-Verständnis ist exklusiv für die X-Suche
- Aktivieren Sie es mit
enable_video_understanding: true - Kombinierbar mit Bildverständnis, Handles und Daten
- Kosten: abgerufene Beiträge und Profile sowie Bild-Token für angeschauten Videos; filtern Sie nach Konten und Daten
- Ideal für Launch-Überwachung, Demo-Analyse und Multimedia-Überwachung