> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utage-system.com/llms.txt
> Use this file to discover all available pages before exploring further.

# メディアツール

> メディアの一覧取得・検索・アップロードツール

## 概要

メディア系ツールでは、動画・音声・通常メディア（画像・PDF等）の一覧取得・検索に加え、2段階アップロード（アップロードURL発行 → 完了通知）ができます。

```
動画フォルダ
  └── 動画
音声フォルダ
  └── 音声
```

<Note>
  動画・音声・メディアのアップロードは2段階方式です。`media_video_upload_url` 等でアップロードURLを発行し、ファイルをアップロードした後に `media_video_complete` 等で完了を通知します。
</Note>

## 動画

### media\_video\_list

アップロード済み動画の一覧を取得します。キーワード検索やフォルダでの絞り込みができます。

**パラメータ:**

| パラメータ       | 型       | 必須 | 説明          |
| ----------- | ------- | -- | ----------- |
| `keyword`   | string  | -  | 動画名で部分一致検索  |
| `folder_id` | string  | -  | フォルダIDで絞り込み |
| `page`      | integer | -  | ページ番号       |
| `per_page`  | integer | -  | 1ページあたりの件数  |

**指示例:**

* 「動画一覧を見せて」
* 「"セミナー"を含む動画を検索して」
* 「特定のフォルダ内の動画を一覧表示して」

***

### media\_video\_folder\_list

動画フォルダの一覧を取得します。パラメータはありません。

**パラメータ:** なし

**指示例:**

* 「動画フォルダの一覧を見せて」

## 音声

### media\_audio\_list

アップロード済み音声ファイルの一覧を取得します。キーワード検索やフォルダでの絞り込みができます。

**パラメータ:**

| パラメータ       | 型       | 必須 | 説明          |
| ----------- | ------- | -- | ----------- |
| `keyword`   | string  | -  | 音声名で部分一致検索  |
| `folder_id` | string  | -  | フォルダIDで絞り込み |
| `page`      | integer | -  | ページ番号       |
| `per_page`  | integer | -  | 1ページあたりの件数  |

**指示例:**

* 「音声ファイル一覧を見せて」
* 「"ポッドキャスト"を含む音声を検索して」

***

### media\_audio\_folder\_list

音声フォルダの一覧を取得します。パラメータはありません。

**パラメータ:** なし

**指示例:**

* 「音声フォルダの一覧を見せて」

## 通常メディア

通常メディア（画像・PDF・Office・動画・音声等）の一覧取得・検索を行います。`media_upload_url` でアップロードしたファイルが対象です。

### media\_list

通常メディア（画像・PDF・Office・動画・音声等）の一覧を取得します。キーワード検索やフォルダでの絞り込みができます。動画/音声要素で再生する動画・音声は `media_video_list` / `media_audio_list` を使用してください。

**パラメータ:**

| パラメータ       | 型       | 必須 | 説明          |
| ----------- | ------- | -- | ----------- |
| `keyword`   | string  | -  | 名前で部分一致検索   |
| `folder_id` | string  | -  | フォルダIDで絞り込み |
| `page`      | integer | -  | ページ番号       |
| `per_page`  | integer | -  | 1ページあたりの件数  |

**指示例:**

* 「アップロード済みメディアの一覧を見せて」
* 「"ロゴ"を含むファイルを検索して」

***

### media\_folder\_list

通常メディアフォルダの一覧を取得します。パラメータはありません。

**パラメータ:** なし

**指示例:**

* 「メディアフォルダの一覧を見せて」

## アップロード

ファイルのアップロードは2段階で行います。`*_upload_url` でアップロードURL（`presigned_post`）を取得し、そのURLへファイル本体をPOSTした後、`*_complete` で確定します。

### media\_upload\_url

通常メディア（画像・PDF・Office・動画・音声等）のアップロードURLを発行します。アップロードしたファイル自体の公開URLが発行されます。動画・音声をファネル・会員サイトの動画/音声要素で再生する場合は `media_video_upload_url` / `media_audio_upload_url` を使用してください。

**パラメータ:**

| パラメータ       | 型      | 必須 | 説明                                           |
| ----------- | ------ | -- | -------------------------------------------- |
| `filename`  | string | 必須 | ファイル名（拡張子含む。例: logo.png）                     |
| `filetype`  | string | 必須 | MIMEタイプ（例: image/png, video/mp4, audio/mpeg） |
| `folder_id` | string | -  | フォルダID。未指定時はルート直下                            |

**指示例:**

* 「画像をアップロードしたい」

***

### media\_complete

通常メディアのアップロード完了を通知します。`presigned_post` へファイル本体をアップロードした後に呼び出します。

**パラメータ:**

| パラメータ      | 型      | 必須 | 説明                                        |
| ---------- | ------ | -- | ----------------------------------------- |
| `media_id` | string | 必須 | `media_upload_url` レスポンスの `data.media_id` |

**指示例:**

* 「アップロードが終わったので確定して」

***

### media\_video\_upload\_url

動画のアップロードURLを発行します。ファネル・会員サイトの動画要素で再生する動画をアップロードします。

**パラメータ:**

| パラメータ       | 型      | 必須 | 説明                          |
| ----------- | ------ | -- | --------------------------- |
| `filename`  | string | 必須 | ファイル名（拡張子含む。例: seminar.mp4） |
| `filetype`  | string | 必須 | MIMEタイプ（例: video/mp4）       |
| `folder_id` | string | -  | フォルダID。未指定時はルート直下           |

**指示例:**

* 「セミナー動画をアップロードしたい」

***

### media\_video\_complete

動画のアップロード完了を通知します。確定すると最適化（エンコード）処理が自動で起動します。

**パラメータ:**

| パラメータ      | 型      | 必須 | 説明                                              |
| ---------- | ------ | -- | ----------------------------------------------- |
| `media_id` | string | 必須 | `media_video_upload_url` レスポンスの `data.media_id` |

**指示例:**

* 「動画のアップロードが終わったので確定して」

***

### media\_audio\_upload\_url

音声のアップロードURLを発行します。ファネル・会員サイトの音声要素で再生する音声をアップロードします。

**パラメータ:**

| パラメータ       | 型      | 必須 | 説明                          |
| ----------- | ------ | -- | --------------------------- |
| `filename`  | string | 必須 | ファイル名（拡張子含む。例: podcast.mp3） |
| `filetype`  | string | 必須 | MIMEタイプ（例: audio/mpeg）      |
| `folder_id` | string | -  | フォルダID。未指定時はルート直下           |

**指示例:**

* 「ポッドキャスト音声をアップロードしたい」

***

### media\_audio\_complete

音声のアップロード完了を通知します。確定すると最適化（エンコード）処理が自動で起動します。

**パラメータ:**

| パラメータ      | 型      | 必須 | 説明                                              |
| ---------- | ------ | -- | ----------------------------------------------- |
| `media_id` | string | 必須 | `media_audio_upload_url` レスポンスの `data.media_id` |

**指示例:**

* 「音声のアップロードが終わったので確定して」