Pular para o conteúdo principal
Um objeto de mídia representa uma foto, um vídeo ou um GIF animado. Objetos de mídia são usados por muitos endpoints da X API e podem ser incluídos em Posts, Mensagens diretas, perfis de usuários, peças criativas de publicidade e outros contextos. Cada objeto de mídia pode ter várias variantes de exibição ou reprodução, com diferentes resoluções ou formatos.

​
Tipos de mídia e limites de tamanho

Limites de tamanho para upload via API
  • Imagem: 5 MB
  • GIF: 15 MB
  • Vídeo: 512 MB (ao usar media_category=amplify_video)

​
Criação

Objetos como Posts, Mensagens diretas, fotos de perfil de usuários, cards de Ads hospedados etc. podem conter um ou mais objetos de mídia. Esses objetos de nível superior são coletivamente conhecidos como entidades. A API de criação da entidade relevante (por exemplo, POST /2/tweets) pode receber um ou mais objetos de mídia por meio de um media_id exclusivo. Uma entidade que contém objeto(s) de mídia pode ser criada seguindo estas etapas:
  1. Faça upload do(s) arquivo(s) de mídia usando o upload fragmentado recomendado (imagens/GIF/vídeo) ou o upload simples mais antigo (apenas imagens).
  2. Receba um media_id da etapa 1. Esta etapa pode ser repetida várias vezes com mídias diferentes se a entidade permitir que vários parâmetros media_id sejam informados.
  3. Crie a entidade chamando o endpoint apropriado, incluindo o media_id e outros parâmetros obrigatórios. Por exemplo, associe um media_id a um Post usando o endpoint POST /2/tweets.

​
Recuperação

Consulte o Objeto de Mídia no dicionário de dados.
⌘I