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

# MediaClient

> X API SDK의 media.client Python 모듈에 대한 참조입니다. X API v2의 media 엔드포인트를 호출하기 위한 클라이언트 클래스와 메서드입니다.

## MediaClient

<Badge color="blue">Class</Badge>

<Badge color="gray">기반 클래스: object</Badge>

미디어 작업을 위한 클라이언트

## 생성자

### `__init__`

#### 매개변수

<ParamField path="path.client" type="Client" />

### `append_upload`

Append Media upload
Appends data to a Media upload request.

#### 매개변수

<ParamField path="path.id" type="Any">
  The media identifier for the media to perform the append operation.
</ParamField>

<ParamField path="body.body" type="AppendUploadRequest">
  요청 본문
</ParamField>

### `create_metadata`

Create Media metadata
Creates metadata for a Media file.
body: 요청 본문
:returns: 응답 데이터
:rtype: CreateMetadataResponse

#### 매개변수

<ParamField path="body.body" type="CreateMetadataRequest" />

### `create_subtitles`

Create Media subtitles
Creates subtitles for a specific Media file.
body: 요청 본문
:returns: 응답 데이터
:rtype: CreateSubtitlesResponse

#### 매개변수

<ParamField path="body.body" type="CreateSubtitlesRequest" />

### `delete_subtitles`

Delete Media subtitles
Deletes subtitles for a specific Media file.
body: 요청 본문
:returns: 응답 데이터
:rtype: DeleteSubtitlesResponse

#### 매개변수

<ParamField path="body.body" type="DeleteSubtitlesRequest" />

### `finalize_upload`

Finalize Media upload
Finalizes a Media upload request.

#### 매개변수

<ParamField path="path.id" type="Any">
  The media id of the targeted media to finalize.
</ParamField>

#### 반환값

`FinalizeUploadResponse` - 응답 데이터

### `get_analytics`

Get Media analytics
Retrieves analytics data for media.

#### 매개변수

<ParamField path="path.media_keys" type="List">
  A comma separated list of Media Keys. 단일 요청에서 최대 100개까지 허용됩니다.
</ParamField>

<ParamField path="path.end_time" type="str">
  YYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
</ParamField>

<ParamField path="path.start_time" type="str">
  YYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
</ParamField>

<ParamField path="path.granularity" type="str">
  The granularity for the search counts results.
</ParamField>

<ParamField path="path.media_analytics_fields" type="List or None" default="None">
  A comma separated list of MediaAnalytics fields to display.
</ParamField>

#### 반환값

`GetAnalyticsResponse` - 응답 데이터

### `get_by_key`

Get Media by media key
Retrieves details of a specific Media file by its media key.

#### 매개변수

<ParamField path="path.media_key" type="Any">
  A single Media Key.
</ParamField>

<ParamField path="path.media_fields" type="List or None" default="None">
  표시할 Media 필드의 쉼표로 구분된 목록입니다.
</ParamField>

#### 반환값

`GetByKeyResponse` - 응답 데이터

### `get_by_keys`

Get Media by media keys
Retrieves details of Media files by their media keys.

#### 매개변수

<ParamField path="path.media_keys" type="List">
  A comma separated list of Media Keys. 단일 요청에서 최대 100개까지 허용됩니다.
</ParamField>

<ParamField path="path.media_fields" type="List or None" default="None">
  표시할 Media 필드의 쉼표로 구분된 목록입니다.
</ParamField>

#### 반환값

`GetByKeysResponse` - 응답 데이터

### `get_upload_status`

Get Media upload status
Retrieves the status of a Media upload by its ID.

#### 매개변수

<ParamField path="path.media_id" type="Any">
  Media id for the requested media upload status.
</ParamField>

<ParamField path="path.command" type="str or None" default="None">
  The command for the media upload request.
</ParamField>

#### 반환값

`GetUploadStatusResponse` - 응답 데이터

### `initialize_upload`

Initialize media upload
Initializes a media upload.
body: 요청 본문
:returns: 응답 데이터
:rtype: InitializeUploadResponse

#### 매개변수

<ParamField path="body.body" type="InitializeUploadRequest" />

### `upload`

Upload media
Uploads a media file for use in posts or other content.
body: 요청 본문
:returns: 응답 데이터
:rtype: UploadResponse

#### 매개변수

<ParamField path="body.body" type="UploadRequest" />