메인 콘텐츠로 건너뛰기
POST
/
2
/
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
}
'
{
  "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
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://generaltranslation.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

인증

​
Authorization
string
header
필수

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

본문

​
media
필수

업로드할 파일입니다.

​
media_category
enum<string>
필수

미디어 사용 사례를 식별하는 문자열형 enum 값입니다. 이 식별자는 사용 사례별 제약 조건(예: 파일 크기)을 적용하고, 고급 기능을 활성화하는 데 사용됩니다.

사용 가능한 옵션:
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

이 미디어가 공유되었는지 여부입니다.

응답

요청이 성공했습니다.

미디어 업로드 요청 상태를 GET으로 조회할 때 반환되는 응답입니다.

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

IETF RFC 7807(https://tools.ietf.org/html/rfc7807)에 정의된 HTTP Problem Details 객체