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

# 媒體管理

> 透過 Media Flow 上傳、整理及提供媒體檔案

Media Flow 讓您透過 [BRICKS Controller](/zh-Hant/controller) 上傳、整理及提供媒體檔案。您的應用程式可以顯示透過 BRICKS CDN 提供的圖片、影片及其他媒體。

<Info>
  Media Flow 需要啟用 Media Flow 的工作區。請查看您的工作區訂閱以確認是否可用。
</Info>

## Media Box

Media Box 是按類別或用途整理檔案的容器。每個 Media Box 存放一組媒體檔案集合。

### 建立 Media Box

1. 在 BRICKS Controller 中，前往 **Media**
2. 點擊 **Create Box**
3. 輸入 Media Box 名稱

### 檢視 Media Box 中的檔案

點擊 Media Box 即可瀏覽其中的檔案。您可以依以下條件篩選：

* **檔案類型** —圖片、影片、文件
* **使用者標籤** —您指定給檔案的自訂標籤

## 上傳檔案

<Steps>
  <Step title="開啟 Media Box">
    前往您要上傳檔案的 Media Box。
  </Step>

  <Step title="上傳">
    點擊 **Upload** 並從電腦中選取一個或多個檔案。
  </Step>

  <Step title="設定選項">
    新增說明、標籤，並設定影像處理選項。
  </Step>
</Steps>

### 上傳選項

| 選項                 | 說明                        |
| ------------------ | ------------------------- |
| **Description**    | 檔案的文字說明                   |
| **User tags**      | 用於整理和篩選的自訂標籤（每個檔案最多 15 個） |
| **Image versions** | 以特定尺寸產生縮放版本（例如 `800x600`） |
| **AI analysis**    | 對檔案執行 AI 分析，可選填自訂指令       |

## 影像處理

上傳圖片時，您可以以特定尺寸產生額外版本：

* 定義目標尺寸（例如 `800x600`）
* 選擇填充模式（例如 `FILL`、`FIT`）
* 選取輸出格式

處理後的版本會與原始檔案一起存放，並透過 CDN 提供。

## 在應用程式中使用媒體

您的應用程式透過 BRICKS CDN 存取媒體檔案。檔案透過最佳化的快取和傳送機制提供。

## CLI 存取

您也可以透過 [BRICKS CLI](/zh-Hant/cli) 管理媒體：

```bash theme={null}
# 列出 Media Box
bricks media boxes

# 列出 Media Box 中的檔案
bricks media files <box-id>

# 上傳含標籤和影像處理設定的檔案
bricks media upload <box-id> image.png -t "banner" --image-version "800x600:FILL"
```