メディアをアップロード

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

import requests

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

payload = {
    "media": "<string>",
    "media_category": "tweet_image",
    "additional_owners": ["2244994945"],
    "media_type": "image/png",
    "shared": False
}
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({
    media: '<string>',
    media_category: 'tweet_image',
    additional_owners: ['2244994945'],
    media_type: 'image/png',
    shared: false
  })
};

fetch('https://api.x.com/2/media/upload', 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",
  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([
    'media' => '<string>',
    'media_category' => 'tweet_image',
    'additional_owners' => [
        '2244994945'
    ],
    'media_type' => 'image/png',
    'shared' => false
  ]),
  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"

	payload := strings.NewReader("{\n  \"media\": \"<string>\",\n  \"media_category\": \"tweet_image\",\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_type\": \"image/png\",\n  \"shared\": false\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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"media\": \"<string>\",\n  \"media_category\": \"tweet_image\",\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_type\": \"image/png\",\n  \"shared\": false\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"media\": \"<string>\",\n  \"media_category\": \"tweet_image\",\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_type\": \"image/png\",\n  \"shared\": false\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,
      "state": "succeeded"
    },
    "size": 123
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

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

POST

media

upload

メディアをアップロード

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

import requests

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

payload = {
    "media": "<string>",
    "media_category": "tweet_image",
    "additional_owners": ["2244994945"],
    "media_type": "image/png",
    "shared": False
}
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({
    media: '<string>',
    media_category: 'tweet_image',
    additional_owners: ['2244994945'],
    media_type: 'image/png',
    shared: false
  })
};

fetch('https://api.x.com/2/media/upload', 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",
  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([
    'media' => '<string>',
    'media_category' => 'tweet_image',
    'additional_owners' => [
        '2244994945'
    ],
    'media_type' => 'image/png',
    'shared' => false
  ]),
  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"

	payload := strings.NewReader("{\n  \"media\": \"<string>\",\n  \"media_category\": \"tweet_image\",\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_type\": \"image/png\",\n  \"shared\": false\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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"media\": \"<string>\",\n  \"media_category\": \"tweet_image\",\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_type\": \"image/png\",\n  \"shared\": false\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"media\": \"<string>\",\n  \"media_category\": \"tweet_image\",\n  \"additional_owners\": [\n    \"2244994945\"\n  ],\n  \"media_type\": \"image/png\",\n  \"shared\": false\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,
      "state": "succeeded"
    },
    "size": 123
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

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

承認

Authorization

string

header

必須

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

Scopes

media.write

Upload media, such as photos and videos, on your behalf.

ボディ

media

必須

アップロードするファイル。

media_category

enum<string>

必須

メディアのユースケースを識別する文字列列挙型の値です。この識別子は、ユースケース固有の制約（例：ファイルサイズ）を適用し、高度な機能を有効にするために使用されます。

利用可能なオプション:

tweet_image,

dm_image,

subtitles

例:

"tweet_image"

additional_owners

string[]

このユーザーの一意の識別子。大きな整数値を扱えない言語やツールとの互換性の問題を避けるため、文字列として返されます。

Pattern: ^[0-9]{1,19}$

media_type

enum<string>

画像または字幕の種類。

利用可能なオプション:

text/srt,

text/vtt,

image/jpeg,

image/bmp,

image/png,

image/webp,

image/pjpeg,

image/tiff

例:

"image/png"

shared

boolean

デフォルト:false

このメディアが共有されているかどうか。

レスポンス

リクエストは成功しました。

メディアアップロードリクエストのステータス取得に対するレスポンス。

data

object

Show child attributes

errors

object[]

Minimum array length: 1

IETF RFC 7807 (https://tools.ietf.org/html/rfc7807) で定義された HTTP Problem Details オブジェクト。

Show child attributes

概要

投稿

ユーザー

ダイレクトメッセージ

いいね

リスト

スペース

コミュニティ

コミュニティノート

トレンド

ニュース

メディア

X のアクティビティ

利用状況

ストリーム接続

コンプライアンス

Enterprise v2

いいねのストリーム

GNIP 2.0

メディアをアップロード

承認

Scopes

ボディ

レスポンス