Compréhension vidéo sur X

Corrigé le 3 novembre 2026. L’exemple « xAI SDK » appelait client.responses.create(), méthode qui n’existe pas dans xai-sdk : avec ce SDK, l’outil x_search() se passe à client.chat.create(). Les exemples du SDK openai déclarent maintenant leur client pointé vers https://api.x.ai/v1. La période se termine avant to_date, exclu, d’où un mois d’avril qui finit au 2026-05-01. Le compte xaboratory n’existait pas : l’exemple filtre sur xai. Le coût est décrit tel que xAI le facture (la vision des images et vidéos est comptée en tokens d’image), sans le classement chiffré qui n’avait pas de source. Code vérifié avec xai-sdk 1.21.0 et openai 3.42.1. Sources : X Search · Pricing.

Analyser les vidéos publiées sur X

X Search dispose d’une fonctionnalité exclusive que Web Search ne propose pas : la compréhension vidéo. Avec le paramètre enable_video_understanding, le modèle peut analyser le contenu des vidéos publiées dans les posts X qu’il trouve pendant sa recherche. Combinée à la compréhension d’images, cette capacité fait de X Search un outil d’analyse multimédia complet.

Activation

L’activation se fait via le paramètre enable_video_understanding :

{
  "tools": [{
    "type": "x_search",
    "enable_video_understanding": true
  }]
}

Vous pouvez activer simultanément la compréhension d’images et de vidéos :

{
  "tools": [{
    "type": "x_search",
    "enable_image_understanding": true,
    "enable_video_understanding": true
  }]
}

Syntaxe par SDK

xAI SDK (Python)

from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search

client = Client()  # clé lue dans 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("Analyse les dernières démos vidéo de produits IA sur X"))

response = chat.sample()
print(response.content)
print(response.citations)

Dans ce SDK, from_date et to_date sont des objets datetime, et non des chaînes.

OpenAI SDK (Python)

Les exemples suivants utilisent ce 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="Analyse les dernières démos vidéo de produits IA sur 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,
  }),
},

Cas d’usage

Monitoring de lancements produits

Les entreprises tech publient fréquemment des démos vidéo de leurs produits sur X. Avec la compréhension vidéo, vous pouvez automatiser l’analyse de ces contenus :

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Quelles nouvelles fonctionnalités ont été montrées en vidéo par les entreprises d'IA cette semaine ?",
    tools=[{
        "type": "x_search",
        "enable_video_understanding": True,
        "from_date": "2026-10-27",
        "to_date": "2026-11-03"  # exclu : jusqu'au 2 novembre inclus
    }]
)

Analyse de tutoriels

Les développeurs partagent souvent des tutoriels vidéo courts sur X. La compréhension vidéo permet d’extraire les informations clés sans regarder chaque vidéo.

Veille créative

Pour les équipes marketing ou design, analyser les vidéos de tendances, les publicités créatives ou les contenus viraux publiés sur X.

Combinaison complète des paramètres

X Search atteint sa pleine puissance quand vous combinez tous ses paramètres :

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Résume les démos vidéo publiées par xAI en octobre",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["xai"],   # sans @, 20 comptes au plus
        "from_date": "2026-10-01",
        "to_date": "2026-11-01",        # exclu : tout le mois d'octobre
        "enable_image_understanding": True,
        "enable_video_understanding": True
    }]
)

Cette requête combine quatre filtres : comptes spécifiques, fenêtre temporelle, analyse d’images et analyse de vidéos.

Impact sur les coûts et les performances

D’après la grille de xAI, l’outil X Search est facturé au nombre de posts et de profils récupérés (5 $ les 1 000 posts, 10 $ les 1 000 profils), et la vision des images et vidéos trouvées s’ajoute en tokens, comptés comme des tokens d’image. Une requête qui ouvre beaucoup de vidéos peut donc coûter nettement plus qu’une recherche en texte seul. La discipline tient en trois gestes. N’activez la fonctionnalité que lorsque les vidéos sont réellement essentielles à la question posée. Réduisez le corpus en amont avec les filtres de comptes et de dates, qui s’appliquent à chaque recherche lancée par le modèle : moins de posts candidats, c’est moins de vidéos à regarder. Et surveillez la consommation de ces requêtes : la réponse indique combien de posts et de profils ont été récupérés.

Récapitulatif des capacités multimédia

La compréhension vidéo est une exclusivité de X Search. Si vous avez besoin d’analyser des vidéos trouvées sur le web (hors X), vous devrez utiliser d’autres approches comme l’envoi direct de contenus visuels au modèle.

Points clés à retenir

• La compréhension vidéo est une exclusivité de X Search
• Activez avec enable_video_understanding: true
• Combinable avec la compréhension d’images, les handles et les dates
• Coût : posts et profils récupérés, plus les tokens d’image des vidéos regardées ; filtrez par comptes et dates
• Idéal pour le monitoring de lancements, l’analyse de démos et la veille multimédia