> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 미디어 업로드

<div id="overview">
  ## 개요
</div>

미디어 객체는 하나의 사진, 동영상 또는 애니메이티드 GIF를 나타냅니다. 미디어 객체는 Twitter API의 여러 엔드포인트에서 사용되며, Tweet, 다이렉트 메시지, 사용자 프로필, 광고 크리에이티브(소재) 등 다양한 곳에 포함될 수 있습니다. 각 미디어 객체는 해상도나 형식이 다른 여러 표시용 또는 재생용 변형(variant)을 가질 수 있습니다.

<div id="media-types-size-restrictions">
  ## 미디어 유형 및 크기 제한
</div>

API를 통한 업로드 시 크기 제한

* 이미지 5 MB
* GIF 15 MB
* 동영상 512 MB (media\_category=amplify 사용 시)

<div id="creation">
  ## 생성
</div>

Tweet, 다이렉트 메시지, 사용자 프로필 사진, 호스팅된 Ads 카드 등의 객체에는 하나 이상의 미디어 객체가 포함될 수 있습니다. 이러한 최상위 객체를 통칭해 엔티티라고 합니다. 관련 엔티티 생성 API(예: POST statuses/update)는 고유한 media\_id를 사용해 하나 이상의 미디어 객체를 전달받을 수 있습니다.

미디어 객체를 포함하는 엔티티는 다음 단계를 따라 생성할 수 있습니다.

1. 권장되는 청크 업로드(이미지/GIF/비디오) 또는 이전 방식인 단순 업로드(이미지만)를 사용해 미디어 파일을 업로드합니다.
2. 1단계에서 media\_id를 받습니다. 엔티티에서 여러 media\_id 파라미터 전달을 허용하는 경우, 서로 다른 미디어에 대해 이 단계를 여러 번 반복할 수 있습니다.
3. media\_id 및 기타 필수 파라미터를 포함해 적절한 엔드포인트를 호출하여 엔티티를 생성합니다. 예를 들어, POST statuses/update 엔드포인트를 사용해 Tweet에 media\_id를 첨부할 수 있습니다.

<div id="retrieving">
  ## 가져오기
</div>

Tweet 데이터 사전의 Media Object 항목을 참고하세요.

<div id="right-sidebar-content">
  ## 오른쪽 사이드바 내용
</div>

<div id="guides">
  ## 가이드
</div>

<div id="media-best-practices">
  ### 미디어 모범 사례
</div>

<div id="chunked-media-upload">
  ### 청크 방식 미디어 업로드
</div>

<div id="api-reference">
  ## API 참조 문서
</div>

<div id="post-mediaupload-init">
  ### POST media/upload (INIT)
</div>

<div id="post-mediaupload-append">
  ### POST media/upload (APPEND)
</div>

<div id="get-mediaupload-status">
  ### GET media/upload (STATUS)
</div>

<div id="post-mediaupload-finalize">
  ### POST media/upload (최종 완료)
</div>

<div id="post-mediaupload">
  ### POST media/upload
</div>

<div id="post-mediametadatacreate">
  ### POST media/metadata/create
</div>

<div id="post-mediasubtitlesdelete">
  ### POST media/subtitles/delete
</div>

<div id="post-mediasubtitlescreate">
  ### POST media/subtitles/create
</div>