Passer au contenu principal
POST
/
2
/
media
/
upload
/
initialize
Initialiser le téléversement de médias
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
    }
  ]
}

Autorisations

​
Authorization
string
header
requis

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

Corps

application/json
​
additional_owners
string[]

Identifiant unique de cet utilisateur. Il est renvoyé sous forme de chaîne de caractères afin d’éviter les problèmes avec les langages et outils qui ne prennent pas en charge les entiers de grande taille.

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

Une valeur d’énumération (enum) sous forme de chaîne permettant d’identifier un cas d’usage média. Cet identifiant est utilisé pour appliquer des contraintes spécifiques au cas d’usage (par exemple, taille de fichier, durée de la vidéo) et activer des fonctionnalités avancées.

Options disponibles:
amplify_video,
tweet_gif,
tweet_image,
tweet_video,
dm_gif,
dm_image,
dm_video,
subtitles
Exemple:

"tweet_video"

​
media_type
enum<string>

Type de média.

Options 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
Exemple:

"video/mp4"

​
shared
boolean

Indique si ce média est partagé ou non.

​
total_bytes
integer

Taille totale du média téléversé, en octets.

Plage requise: 0 <= x <= 17179869184

Réponse

La requête a réussi.

Réponse renvoyée lors de la récupération du statut d’une requête de téléversement de média.

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

Un objet HTTP Problem Details, tel que défini dans la RFC IETF 7807 (https://tools.ietf.org/html/rfc7807).