Compreensão de Vídeo no X
Nesta página
Atualizado a 3 de novembro de 2026. O exemplo do SDK xAI utilizava originalmente
client.responses.create(), um método que não existe noxai-sdk. Com este SDK, deve passar a ferramentax_search()paraclient.chat.create(). Os exemplos do SDK OpenAI configuram agora o cliente para apontar parahttps://api.x.ai/v1. O período termina antes deto_date(exclusivo), pelo que um período de abril termina a2026-05-01. A contaxaboratorynão existia; o exemplo filtra agora porxai. As descrições de custos correspondem à faturação da xAI (a visão de imagem e vídeo conta como tokens de imagem); foi removida a classificação numérica sem fontes. Código verificado comxai-sdk1.21.0 eopenai3.42.1. Fontes: X Search · Preçário.
Analisar Vídeos Publicados no X
O X Search oferece uma funcionalidade exclusiva que a Pesquisa Web não tem: a compreensão de vídeo. Com o parâmetro enable_video_understanding, o modelo consegue analisar o conteúdo de vídeo nos publicações do X que encontra durante a sua pesquisa. Combinada com a compreensão de imagem, esta capacidade torna o X Search uma ferramenta completa de análise multimédia.
Ativação
Ative-a através do parâmetro enable_video_understanding:
{
"tools": [{
"type": "x_search",
"enable_video_understanding": true
}]
}
Pode ativar a compreensão de imagem e de vídeo simultaneamente:
{
"tools": [{
"type": "x_search",
"enable_image_understanding": true,
"enable_video_understanding": true
}]
}
Sintaxe do SDK
xAI SDK (Python)
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import x_search
client = Client() # chave lida 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("Analyze the latest AI product video demos on X"))
response = chat.sample()
print(response.content)
print(response.citations)
Neste SDK, from_date e to_date são objetos datetime, não cadeias de caracteres.
OpenAI SDK (Python)
Os exemplos seguintes utilizam 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="Analyze the latest AI product video demos on 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,
}),
},
Casos de Utilização
Monitorização de Lançamentos de Produtos
As empresas de tecnologia publicam frequentemente demonstrações em vídeo dos seus produtos no X. Com a compreensão de vídeo, pode automatizar a análise deste conteúdo:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What new features were shown in video by AI companies this week?",
tools=[{
"type": "x_search",
"enable_image_understanding": True,
"from_date": "2026-10-27",
"to_date": "2026-11-03" # exclusivo: até 2 de novembro inclusive
}]
)
Análise de Tutoriais
Os programadores partilham frequentemente curtos tutoriais em vídeo no X. A compreensão de vídeo permite-lhe extrair informações-chave sem ter de ver todos os vídeos.
Monitorização Criativa
As equipas de marketing ou de design podem analisar vídeos de tendências, anúncios criativos ou conteúdos virais publicados no X.
Combinação Completa de Parâmetros
O X Search atinge todo o seu potencial quando combina todos os seus parâmetros:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Summarize video demos published by xAI in October",
tools=[{
"type": "x_search",
"allowed_x_handles": ["xai"], # sem @, máx. 20 contas
"from_date": "2026-10-01",
"to_date": "2026-11-01", # exclusivo: todo o mês de outubro
"enable_image_understanding": True,
"enable_video_understanding": True
}]
)
Esta consulta combina quatro filtros: contas específicas, janela temporal, análise de imagem e análise de vídeo.
Impacto nos Custos e no Desempenho
De acordo com a grelha de preços da xAI, a ferramenta X Search é faturada pelo número de publicações e perfis recuperados (5 USD por 1.000 publicações, 10 USD por 1.000 perfis), e a visão para imagens e vídeos encontrados adiciona tokens, contados como tokens de imagem. Uma consulta que abre muitos vídeos pode, portanto, custar significativamente mais do que uma pesquisa apenas de texto. A disciplina resume-se a três passos. Ative a funcionalidade apenas quando os vídeos forem verdadeiramente essenciais para a pergunta. Reduza o corpus a montante com filtros de conta e data, que se aplicam a todas as pesquisas lançadas pelo modelo: menos publicações candidatas significa menos vídeos para analisar. E monitore o consumo das consultas: a resposta indica quantas publicações e perfis foram recuperados.
Resumo das Capacidades Multimédia
| Funcionalidade | Pesquisa Web | X Search |
|---|---|---|
| Texto | Sim | Sim |
Imagens (enable_image_understanding) | Sim | Sim |
Vídeo (enable_video_understanding) | Não | Sim |
A compreensão de vídeo é uma exclusividade do X Search. Se precisar de analisar vídeos encontrados na web (fora do X), terá de utilizar outras abordagens, como enviar o conteúdo visual diretamente para o modelo.
Pontos-chave
- A compreensão de vídeo é uma exclusividade do X Search
- Ative com
enable_video_understanding: true - Combinável com compreensão de imagem, handles e datas
- Custo: publicações e perfis recuperados, mais tokens de imagem para vídeos visualizados; filtre por contas e datas
- Ideal para monitorização de lançamentos, análise de demonstrações e monitorização multimédia