Téléversement de médias par segments

Ce guide vous explique étape par étape comment téléverser des vidéos et des fichiers média volumineux à l’aide du flux de travail de téléversement par segments. Pour les téléversements de vidéos ou de médias volumineux, vous devez :

INIT — Initialiser le téléversement et obtenir un media_id
APPEND — Téléverser chaque segment du fichier
FINALIZE — Terminer le téléversement
STATUS — (Si nécessaire) Attendre que le traitement soit terminé

Consultez cet exemple de code pour un exemple complet en Python.

Étape 1 : Initialiser le téléversement (INIT)

Démarrez la session de téléversement pour obtenir un media_id :

cURL

curl -X POST "https://api.x.com/2/media/upload" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "command=INIT" \
  -F "media_type=video/mp4" \
  -F "total_bytes=1048576" \
  -F "media_category=amplify_video"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Initialiser le téléversement par segments
response = client.media.init_upload(
    media_type="video/mp4",
    total_bytes=1048576,
    media_category="amplify_video"
)

media_id = response.data.id
print(f"Media ID: {media_id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Initialiser le téléversement par segments
const response = await client.media.initUpload({
  mediaType: "video/mp4",
  totalBytes: 1048576,
  mediaCategory: "amplify_video",
});

const mediaId = response.data?.id;
console.log(`Media ID: ${mediaId}`);

Réponse :

{
  "data": {
    "id": "1880028106020515840",
    "media_key": "13_1880028106020515840",
    "expires_after_secs": 1295999
  }
}

Étape 2 : Téléverser les segments (APPEND)

Téléversez chaque segment du fichier. Par exemple, découpez un fichier de 3 Mo en 3 segments :

cURL

curl -X POST "https://api.x.com/2/media/upload" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "command=APPEND" \
  -F "media_id=1880028106020515840" \
  -F "segment_index=0" \
  -F "media=@/path/to/chunk1.mp4"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Téléverser les segments
chunk_size = 1024 * 1024  # segments de 1 Mo

with open("video.mp4", "rb") as f:
    segment_index = 0
    while True:
        chunk = f.read(chunk_size)
        if not chunk:
            break
        
        client.media.append_upload(
            media_id=media_id,
            segment_index=segment_index,
            media=chunk
        )
        segment_index += 1
        print(f"Uploaded chunk {segment_index}")

import { Client } from "@xdevplatform/xdk";
import fs from "fs";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Téléverser les segments
const chunkSize = 1024 * 1024; // segments de 1 Mo
const fileBuffer = fs.readFileSync("video.mp4");

let segmentIndex = 0;
for (let offset = 0; offset < fileBuffer.length; offset += chunkSize) {
  const chunk = fileBuffer.slice(offset, offset + chunkSize);
  
  await client.media.appendUpload({
    mediaId,
    segmentIndex,
    media: chunk,
  });
  
  console.log(`Uploaded chunk ${segmentIndex + 1}`);
  segmentIndex++;
}

Avantages du découpage en segments :

Fiabilité améliorée sur les réseaux lents
Les téléversements peuvent être mis en pause et repris
Les segments qui ont échoué peuvent être retentés individuellement

Étape 3 : Finaliser le téléversement (FINALIZE)

Finalisez le téléversement après l’envoi de tous les blocs :

cURL

curl -X POST "https://api.x.com/2/media/upload" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "command=FINALIZE" \
  -F "media_id=1880028106020515840"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Finaliser le téléversement
response = client.media.finalize_upload(media_id=media_id)

print(f"État du traitement : {response.data.processing_info.state}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Finaliser le téléversement
const response = await client.media.finalizeUpload({ mediaId });

console.log(`État du traitement : ${response.data?.processing_info?.state}`);

Réponse :

{
  "data": {
    "id": "1880028106020515840",
    "media_key": "13_1880028106020515840",
    "size": 1048576,
    "expires_after_secs": 86400,
    "processing_info": {
      "state": "pending",
      "check_after_secs": 1
    }
  }
}

Si processing_info est retourné, passez à l’étape 4 pour attendre la fin du traitement. Sinon, le média est prêt à être utilisé.

Étape 4 : Vérifier le statut (STATUS)

Si processing_info est renvoyé, interrogez l’API jusqu’à la fin du traitement :

cURL

curl "https://api.x.com/2/media/upload?command=STATUS&media_id=1880028106020515840" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
import time

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Attendre la fin du traitement
while True:
    response = client.media.get_status(media_id=media_id)
    state = response.data.processing_info.state
    
    if state == "succeeded":
        print("Média prêt !")
        break
    elif state == "failed":
        print("Échec du traitement")
        break
    else:
        check_after = response.data.processing_info.check_after_secs
        print(f"Traitement en cours... nouvelle vérification dans {check_after}s")
        time.sleep(check_after)

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Attendre la fin du traitement
while (true) {
  const response = await client.media.getStatus({ mediaId });
  const state = response.data?.processing_info?.state;
  
  if (state === "succeeded") {
    console.log("Média prêt !");
    break;
  } else if (state === "failed") {
    console.log("Échec du traitement");
    break;
  } else {
    const checkAfter = response.data?.processing_info?.check_after_secs ?? 1;
    console.log(`Traitement en cours... nouvelle vérification dans ${checkAfter}s`);
    await new Promise((r) => setTimeout(r, checkAfter * 1000));
  }
}

États de traitement : pending → in_progress → succeeded ou failed

Étape 5 : Créer une Publication avec un média

Une fois le traitement terminé, créez une Publication avec un média :

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Regardez cette vidéo !",
    "media": {
      "media_ids": ["1880028106020515840"]
    }
  }'

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Créer une Publication avec un média
response = client.posts.create(
    text="Regardez cette vidéo !",
    media={"media_ids": [media_id]}
)

print(f"Publication publiée : {response.data.id}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Créer une Publication avec un média
const response = await client.posts.create({
  text: "Regardez cette vidéo !",
  media: { mediaIds: [mediaId] },
});

console.log(`Publication publiée : ${response.data?.id}`);

Catégories de médias

Catégorie	Description
`tweet_image`	Image pour une Publication
`tweet_gif`	GIF animé pour une Publication
`tweet_video`	Vidéo pour une Publication
`amplify_video`	Vidéo Amplify

Prochaines étapes

Bonnes pratiques

Contraintes et exigences relatives aux fichiers

Créer des Publications

Publication avec des médias

Référence de l’API

Documentation complète de l’endpoint

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Téléversement de médias par segments

Étape 1 : Initialiser le téléversement (INIT)

Étape 2 : Téléverser les segments (APPEND)

Étape 3 : Finaliser le téléversement (FINALIZE)

Étape 4 : Vérifier le statut (STATUS)

Étape 5 : Créer une Publication avec un média

Catégories de médias

Prochaines étapes

Bonnes pratiques

Créer des Publications

Référence de l’API