Saltar al contenido principal
POST
/
2
/
media
/
upload
Cargar medios
curl --request POST \
  --url https://api.x.com/2/media/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "media": "<string>",
  "media_category": "tweet_image",
  "additional_owners": [
    "2244994945"
  ],
  "media_type": "image/png",
  "shared": false
}
'
{
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

Autorizaciones

​
Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Cuerpo

​
media
requerido

El archivo que se va a subir.

​
media_category
enum<string>
requerido

Un valor de enumeración de tipo cadena (string) que identifica un caso de uso de contenido multimedia. Este identificador se utiliza para aplicar restricciones específicas del caso de uso (por ejemplo, tamaño de archivo) y habilitar funciones avanzadas.

Opciones disponibles:
tweet_image,
dm_image,
subtitles
Ejemplo:

"tweet_image"

​
additional_owners
string[]

Identificador único de este usuario. Se devuelve como una cadena para evitar complicaciones con lenguajes de programación y herramientas que no pueden manejar números enteros grandes.

Pattern: ^[0-9]{1,19}$
​
media_type
enum<string>

El tipo de imagen o subtítulo.

Opciones disponibles:
text/srt,
text/vtt,
image/jpeg,
image/bmp,
image/png,
image/webp,
image/pjpeg,
image/tiff
Ejemplo:

"image/png"

​
shared
boolean
predeterminado:false

Indica si este contenido multimedia se comparte o no.

Respuesta

La solicitud se ha completado correctamente.

Una respuesta al consultar el estado de una solicitud de carga de contenido multimedia.

​
data
object
​
errors
object[]
Minimum array length: 1

Un objeto HTTP Problem Details, tal como se define en el IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).