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

# Upload media

## Overview

A media object represents a single photo, video or animated GIF. Media objects are used by many endpoints within the Twitter API, and may be included in Tweets, Direct Messages, user profiles, advertising creatives and elsewhere. Each media object may have multiple display or playback variants, with different resolutions or formats.

## Media types & size restrictions

Size restrictions for uploading via API

* Image 5 MB
* GIF 15 MB
* Video 512 MB (when using media\_category=amplify)

## Creation

Objects such as Tweets, Direct Messages, user profile pictures, hosted Ads cards, etc. can contain one or more media objects. These top-level objects are collectively known as entities. The relevant entity creation API (e.g. POST statuses/update) can be passed one or more media objects using a unique media\_id.

An entity which contains media object(s) can be created by following these steps:

1. Upload the media file(s) using either the recommended chunked upload (images/GIF/video), or the older simple upload (images only).
2. Receive a media\_id from step 1. This step may be repeated multiple times with different media if the entity allows multiple media\_id parameters to be passed in.
3. Create the entity by calling the appropriate endpoint, including the media\_id and other required parameters. For example, attach a media\_id to a Tweet using the POST statuses/update endpoint.

## Retrieving

Please refer to the Media Object in the Tweet data dictionary.

## Right sidebar content

## Guides

### Media Best Practices

### Chunked media upload

## API Reference

### POST media/upload (INIT)

### POST media/upload (APPEND)

### GET media/upload (STATUS)

### POST media/upload (FINALIZE)

### POST media/upload

### POST media/metadata/create

### POST media/subtitles/delete

### POST media/subtitles/create