Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Compreensão de Vídeo no X

Aula 11 de 16 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Analisar Vídeos Publicados no X
  2. Ativação
  3. Sintaxe do SDK
  4. Casos de Utilização
  5. Combinação Completa de Parâmetros
  6. Impacto nos Custos e no Desempenho
  7. Resumo das Capacidades Multimédia
  8. Pontos-chave

Atualizado a 3 de novembro de 2026. O exemplo do SDK xAI utilizava originalmente client.responses.create(), um método que não existe no xai-sdk. Com este SDK, deve passar a ferramenta x_search() para client.chat.create(). Os exemplos do SDK OpenAI configuram agora o cliente para apontar para https://api.x.ai/v1. O período termina antes de to_date (exclusivo), pelo que um período de abril termina a 2026-05-01. A conta xaboratory não existia; o exemplo filtra agora por xai. 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 com xai-sdk 1.21.0 e openai 3.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

FuncionalidadePesquisa WebX Search
TextoSimSim
Imagens (enable_image_understanding)SimSim
Vídeo (enable_video_understanding)NãoSim

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