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
}
'

import requests

url = "https://api.x.com/2/media/upload/initialize"

payload = {
    "additional_owners": ["2244994945"],
    "media_category": "tweet_video",
    "media_type": "video/mp4",
    "shared": True,
    "total_bytes": 8589934592
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    additional_owners: ['2244994945'],
    media_category: 'tweet_video',
    media_type: 'video/mp4',
    shared: true,
    total_bytes: 8589934592
  })
};

fetch('https://api.x.com/2/media/upload/initialize', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/media/upload/initialize",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'additional_owners' => [
        '2244994945'
    ],
    'media_category' => 'tweet_video',
    'media_type' => 'video/mp4',
    'shared' => true,
    'total_bytes' => 8589934592
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/media/upload/initialize"

	payload := strings.NewReader("{\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_category\": \"tweet_video\",\n  \"media_type\": \"video/mp4\",\n  \"shared\": true,\n  \"total_bytes\": 8589934592\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.x.com/2/media/upload/initialize")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_category\": \"tweet_video\",\n  \"media_type\": \"video/mp4\",\n  \"shared\": true,\n  \"total_bytes\": 8589934592\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/media/upload/initialize")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_category\": \"tweet_video\",\n  \"media_type\": \"video/mp4\",\n  \"shared\": true,\n  \"total_bytes\": 8589934592\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "1146654567674912769",
    "media_key": "<string>",
    "expires_after_secs": 123,
    "processing_info": {
      "check_after_secs": 123,
      "progress_percent": 123
    },
    "size": 123
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

POST

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
}
'

import requests

url = "https://api.x.com/2/media/upload/initialize"

payload = {
    "additional_owners": ["2244994945"],
    "media_category": "tweet_video",
    "media_type": "video/mp4",
    "shared": True,
    "total_bytes": 8589934592
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    additional_owners: ['2244994945'],
    media_category: 'tweet_video',
    media_type: 'video/mp4',
    shared: true,
    total_bytes: 8589934592
  })
};

fetch('https://api.x.com/2/media/upload/initialize', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/media/upload/initialize",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'additional_owners' => [
        '2244994945'
    ],
    'media_category' => 'tweet_video',
    'media_type' => 'video/mp4',
    'shared' => true,
    'total_bytes' => 8589934592
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/media/upload/initialize"

	payload := strings.NewReader("{\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_category\": \"tweet_video\",\n  \"media_type\": \"video/mp4\",\n  \"shared\": true,\n  \"total_bytes\": 8589934592\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.x.com/2/media/upload/initialize")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_category\": \"tweet_video\",\n  \"media_type\": \"video/mp4\",\n  \"shared\": true,\n  \"total_bytes\": 8589934592\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/media/upload/initialize")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_category\": \"tweet_video\",\n  \"media_type\": \"video/mp4\",\n  \"shared\": true,\n  \"total_bytes\": 8589934592\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "1146654567674912769",
    "media_key": "<string>",
    "expires_after_secs": 123,
    "processing_info": {
      "check_after_secs": 123,
      "progress_percent": 123
    },
    "size": 123
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

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

Show child attributes

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

Show child attributes

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Iniciar la carga de medios

Autorizaciones

Cuerpo

Respuesta