Ir al contenido principal
Español— Elegir un idioma
Menú

Comprensión de vídeo en X

Lección 11 de 16 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Analizar vídeos publicados en X
  2. Activación
  3. Sintaxis del SDK
  4. Casos de uso
  5. Combinación completa de parámetros
  6. Impacto en coste y rendimiento
  7. Resumen de capacidades multimedia
  8. Puntos clave

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 en xai-sdk. Con este SDK, pasa la herramienta x_search() a client.chat.create(). Los ejemplos del SDK de OpenAI configuran ahora el cliente para que apunte a https://api.x.ai/v1. El periodo termina antes de to_date (exclusivo), por lo que un periodo de abril finaliza el 2026-05-01. La cuenta xaboratory no existía; el ejemplo filtra ahora por xai. 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 con xai-sdk 1.21.0 y openai 3.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

FuncionalidadBúsqueda webBúsqueda en X
TextoSíSí
Imágenes (enable_image_understanding)SíSí
Vídeo (enable_video_understanding)NoSí

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