소개

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

​

미디어 유형 및 크기 제한

API 업로드 시 크기 제한

• 이미지: 5 MB
• GIF: 15 MB
• 동영상: 512 MB (media_category=amplify_video 사용 시)

​

생성

게시물, 다이렉트 메시지, 사용자 프로필 사진, 호스티드 Ads 카드 등과 같은 객체에는 하나 이상의 미디어 객체가 포함될 수 있습니다. 이러한 최상위 객체를 통칭해 엔터티라고 합니다. 관련 엔터티 생성 API(예: POST /2/tweets)에는 고유한 media_id를 사용해 하나 이상의 미디어 객체를 전달할 수 있습니다.

미디어 객체를 포함하는 엔터티는 다음 단계를 통해 생성할 수 있습니다:

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

​

가져오기

데이터 사전의 Media Object를 참조하세요.