Comprensión de vídeo en X
En esta página
Actualizado el 3 de noviembre de 2026. El ejemplo del SDK de xAI llamaba originalmente a
client.responses.create(), un método que no existe enxai-sdk. Con este SDK, pasa la herramientax_search()aclient.chat.create(). Los ejemplos del SDK de OpenAI configuran ahora el cliente para que apunte ahttps://api.x.ai/v1. El periodo termina antes deto_date(exclusivo), por lo que un periodo de abril finaliza el2026-05-01. La cuentaxaboratoryno existía; el ejemplo filtra ahora porxai. Las descripciones de costes coinciden con la facturación de xAI (la visión de imagen y vídeo cuenta como tokens de imagen); se ha eliminado la clasificación numérica sin fuente. Código verificado conxai-sdk1.21.0 yopenai3.42.1. Fuentes: Búsqueda en X · Precios.
Analizar vídeos publicados en X
La Búsqueda en X ofrece una función exclusiva de la que carece la Búsqueda web: la comprensión de vídeo. Mediante el parámetro enable_video_understanding, el modelo puede analizar el contenido de vídeo dentro de las publicaciones de X que encuentra durante su búsqueda. Combinada con la comprensión de imágenes, esta capacidad convierte a la Búsqueda en X en una herramienta completa de análisis multimedia.
Activación
Actívala mediante el parámetro enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Puedes activar la comprensión de imágenes y vídeo simultáneamente:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
Sintaxis del SDK
SDK de xAI (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # clave leída de 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("Analiza las últimas demostraciones en vídeo de productos de IA en X"))
response = chat.sample()
print(response.content)
print(response.citations)
En este SDK, from_date y to_date son objetos datetime, no cadenas de texto.
SDK de OpenAI (Python)
Los siguientes ejemplos utilizan este cliente:
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="Analiza las últimas demostraciones en vídeo de productos de IA en X",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
SDK de Vercel AI (JavaScript)
tools: {
x_search: xai.tools.xSearch({
enableImageUnderstanding: true,
enableVideoUnderstanding: true,
}),
},
Casos de uso
Supervisión de lanzamientos de productos
Las empresas tecnológicas publican con frecuencia demostraciones en vídeo de sus productos en X. Con la comprensión de vídeo, puedes automatizar el análisis de este contenido:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="¿Qué nuevas funcionalidades mostraron en vídeo las empresas de IA esta semana?",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"from_date": "2026-10-27",
"to_date": "2026-11-03" # exclusivo: hasta el 2 de noviembre inclusive
}]
)
Análisis de tutoriales
Los desarrolladores suelen compartir breves tutoriales en vídeo en X. La comprensión de vídeo te permite extraer información clave sin tener que ver cada vídeo.
Supervisión creativa
Los equipos de marketing o diseño pueden analizar vídeos de tendencias, anuncios creativos o contenido viral publicado en X.
Combinación completa de parámetros
La Búsqueda en X alcanza todo su potencial cuando combinas todos sus parámetros:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Resume las demostraciones en vídeo publicadas por xAI en octubre",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xai"], # sin @, máx. 20 cuentas
"from_date": "2026-10-01",
"to_date": "2026-11-01", # exclusivo: todo octubre
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Esta consulta combina cuatro filtros: cuentas específicas, ventana temporal, análisis de imágenes y análisis de vídeo.
Impacto en coste y rendimiento
Según la tabla de precios de xAI, la herramienta de Búsqueda en X se factura por número de publicaciones y perfiles recuperados (5 $ por cada 1.000 publicaciones, 10 $ por cada 1.000 perfiles), y la visión para imágenes y vídeos encontrados añade tokens, contados como tokens de imagen. Una consulta que abre muchos vídeos puede costar, por tanto, significativamente más que una búsqueda solo de texto. La disciplina se reduce a tres pasos. Activa la función solo cuando los vídeos sean realmente esenciales para la pregunta. Reduce el corpus aguas arriba con filtros de cuenta y fecha, que se aplican a cada búsqueda lanzada por el modelo: menos publicaciones candidatas significa menos vídeos que ver. Y supervisa el consumo de la consulta: la respuesta indica cuántas publicaciones y perfiles se han recuperado.
Resumen de capacidades multimedia
| Funcionalidad | Búsqueda web | Búsqueda en X |
|---|---|---|
| Texto | Sí | Sí |
Imágenes (enable_image_understanding) | Sí | Sí |
Vídeo (enable_video_understanding) | No | Sí |
La comprensión de vídeo es una exclusividad de la Búsqueda en X. Si necesitas analizar vídeos encontrados en la web (fuera de X), tendrás que usar otros enfoques, como enviar el contenido visual directamente al modelo.
Puntos clave
- La comprensión de vídeo es una exclusividad de la Búsqueda en X
- Actívala con
enable_video_understanding: true - Combinable con comprensión de imágenes, handles y fechas
- Coste: publicaciones y perfiles recuperados, más tokens de imagen por los vídeos vistos; filtra por cuentas y fechas
- Ideal para supervisión de lanzamientos, análisis de demostraciones y monitorización multimedia