Compreender Vídeos em Publicações do X
Nesta página
Exclusivo da Pesquisa no X: Análise de Vídeo
A compreensão de vídeo é uma funcionalidade exclusiva do x_search e não está disponível no web_search. Com o vídeo a representar uma quota crescente de conteúdo no X, esta capacidade permite-lhe analisar demonstrações de produtos, clipes de conferências, tutoriais e anúncios em vídeo diretamente através da API.
Ativar a Compreensão de Vídeo
O parâmetro enable_video_understanding adiciona-se à configuração da ferramenta x_search:
response = client.responses.create(
model="grok-4.5",
input="Summarize the latest AI tool video demos shared on X",
tools=[{
"type": "x_search",
"enable_video_understanding": True
}]
)
Quando ativado, o modelo pode visualizar e analisar os vídeos anexados às publicações que encontra durante a sua pesquisa. Extrai o conteúdo visual, o diálogo, o texto no ecrã e o contexto geral.
Compreensão de Imagem no X
O parâmetro enable_image_understanding também funciona com o x_search, tal como com o web_search:
response = client.responses.create(
model="grok-4.5",
input="Analyze infographics shared about AI this week",
tools=[{
"type": "x_search",
"enable_image_understanding": True
}]
)
Pode ativar ambas as análises simultaneamente para obter uma cobertura completa dos média.
| Parâmetro | web_search | x_search | Limite |
|---|---|---|---|
| enable_image_understanding | Sim | Sim | Booleano |
| enable_video_understanding | Não | Sim | Booleano |
| allowed_domains | Sim | Não | Máx. 5 |
| allowed_x_handles | Não | Sim | Máx. 10 |
| from_date / to_date | Não | Sim | ISO 8601 |
Casos de Utilização da Análise de Vídeo
Monitorização de Produtos da Concorrência
Monitore as demonstrações em vídeo dos concorrentes publicadas no X para se manter informado sobre as suas novas funcionalidades sem precisar de ver todas as publicações:
response = client.responses.create(
model="grok-4.5",
input="""Find and analyze AI product demo videos
published this week on X.
For each video, identify: the product,
features shown, and community
reactions.""",
tools=[{
"type": "x_search",
"enable_video_understanding": True,
"from_date": "2026-03-27",
"to_date": "2026-04-03"
}]
)
Resumos de Conferências
Muitos oradores partilham clipes das suas apresentações no X. A análise de vídeo pode resumi-los:
response = client.responses.create(
model="grok-4.5",
input="""Summarize AI presentation videos
shared by these speakers this week.
Extract key points from each talk.""",
tools=[{
"type": "x_search",
"allowed_x_handles": ["AndrewYNg", "karpathy"],
"enable_video_understanding": True
}]
)
Análise de Tutoriais Técnicos
Os programadores partilham frequentemente curtos tutoriais em vídeo no X. A análise de vídeo pode extrair os passos e comandos apresentados:
response = client.responses.create(
model="grok-4.5",
input="""Find video tutorials on deploying
AI models shared on X this week.
Extract key steps and tools used.""",
tools=[{
"type": "x_search",
"enable_video_understanding": True,
"enable_image_understanding": True
}]
)
Impacto no Desempenho
A análise de vídeo é significativamente mais lenta do que a análise de texto. O modelo tem de processar o fluxo de vídeo, extrair os quadros relevantes e analisar o conteúdo visual e áudio. Espere tempos de resposta mais longos e um maior consumo de tokens.
Ative o enable_video_understanding apenas quando o conteúdo em vídeo for essencial para o seu caso de utilização. Para uma monitorização diária rápida do texto das publicações, deixe este parâmetro desativado.
Prática Prática
Crie um script de monitorização que vise 3 contas que partilham regularmente conteúdo em vídeo na sua área. Ative simultaneamente a compreensão de vídeo e de imagem. Compare a riqueza da análise obtida com e sem estes parâmetros ativados e meça a diferença no tempo de resposta.
Pontos-chave
- O
enable_video_understandingé exclusivo dox_search(não disponível noweb_search) - O
enable_image_understandingfunciona em ambas as ferramentas - A análise de vídeo e a análise de imagem podem ser ativadas simultaneamente
- A análise de vídeo aumenta significativamente o tempo de processamento e os tokens consumidos
- Cada ferramenta tem os seus próprios parâmetros: domínios para o
web_search, handles e datas para ox_search - Ative a análise de vídeo apenas quando o conteúdo multimédia for relevante para a sua consulta