> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Endpoints de upload de mídia na API do X v2

> Faça upload de imagens, GIFs e vídeos para o X com chunked ou simple media upload, obtenha valores de media_id e anexe-os a Posts, Direct Messages e perfis.

Um objeto de mídia representa uma única foto, vídeo ou GIF animado. Objetos de mídia são usados por muitos endpoints dentro da API do X e podem ser incluídos em Posts, Direct Messages, perfis de usuário, criativos publicitários e outros locais. Cada objeto de mídia pode ter múltiplas variantes de exibição ou reprodução, com resoluções ou formatos diferentes.

## Tipos de mídia e restrições de tamanho

Restrições de tamanho para upload via API

* **Image**: `5 MB`
* **GIF**: `15 MB`
* **Video**: `512 MB` (ao usar `media_category=amplify_video`)

## Criação

Objetos como Posts, Direct Messages, fotos de perfil de usuário, hosted Ads cards, 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 de entidade relevante (ex.: [`POST /2/tweets`](/x-api/posts/creation-of-a-post)) pode receber um ou mais objetos de mídia usando um `media_id` único.

Uma entidade que contém objeto(s) de mídia pode ser criada seguindo estes passos:

1. Faça upload do(s) arquivo(s) de mídia usando o upload [chunked](/x-api/media/quickstart/media-upload-chunked) recomendado (imagens/GIF/vídeo) ou o upload [simple](/x-api/media/upload-media) mais antigo (apenas imagens).
2. Receba um `media_id` do passo 1. Esta etapa pode ser repetida várias vezes com mídias diferentes se a entidade permitir que múltiplos parâmetros `media_id` sejam passados.
3. Crie a entidade chamando o endpoint apropriado, incluindo o `media_id` e outros parâmetros obrigatórios. Por exemplo, anexe um `media_id` a um Post usando o endpoint [`POST /2/tweets`](/x-api/posts/creation-of-a-post).

## Recuperando

Consulte o [Objeto Media](/x-api/fundamentals/data-dictionary/reference#media) no dicionário de dados.
