Saltar al contenido principal
POST
/
2
/
media
/
upload
/
initialize
Iniciar la carga de medios
curl --request POST \
  --url https://api.x.com/2/media/upload/initialize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "additional_owners": [
    "2244994945"
  ],
  "media_category": "tweet_video",
  "media_type": "video/mp4",
  "shared": true,
  "total_bytes": 8589934592
}
'
{
  "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

application/json
​
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_category
enum<string>

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

Opciones disponibles:
amplify_video,
tweet_gif,
tweet_image,
tweet_video,
dm_gif,
dm_image,
dm_video,
subtitles
Ejemplo:

"tweet_video"

​
media_type
enum<string>

El type de medio.

Opciones disponibles:
video/mp4,
video/webm,
video/mp2t,
video/quicktime,
text/srt,
text/vtt,
image/jpeg,
image/gif,
image/bmp,
image/png,
image/webp,
image/pjpeg,
image/tiff,
model/gltf-binary,
model/vnd.usdz+zip
Ejemplo:

"video/mp4"

​
shared
boolean

Indica si este medio es compartido o no.

​
total_bytes
integer

El tamaño total de la carga de medios en bytes.

Rango requerido: 0 <= x <= 17179869184

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).