小黃老師嘿技術

1. 為什麼選擇 Mac Studio (M2 Max) 跑 AI 影片？

在進入實作之前，先來聊聊為什麼 Mac Studio 是一台「隱藏版」的 AI 神機。傳統的 PC 顯示卡 (GPU) 雖然強大，但顯示記憶體 (VRAM) 通常只有 16GB 到 24GB，這在處理龐大的影像生成模型時常常會遇到「記憶體不足 (Out of Memory)」的窘境。而 Apple Silicon (像是 M2 Max 或 M2 Ultra) 採用了革命性的「統一記憶體架構 (Unified Memory)」！這意味著，如果你買的是 64GB 甚至 96GB 版本的 Mac Studio，你的 GPU 幾乎可以直接調用這麼龐大的記憶體空間來跑 AI 模型。這讓我們能夠在本機端流暢地處理 4K 解析度的高階運算，不需依賴昂貴的雲端伺服器，且所有的生成資料都安全地保存在你的硬碟裡，這對於注重隱私的企業或部落客來說，絕對是無可取代的優勢。

2. 準備環境與必備安裝工具

要在 Mac 上順利執行 AI 生成，我們需要幾個強大的命令列工具。別擔心，過程非常簡單。請打開你 Mac 上的「終端機 (Terminal)」，我們將依序安裝 Homebrew、ffmpeg 以及這次的核心工具 generate‑media。

首先，如果你的電腦還沒有安裝 macOS 的套件管理神器 Homebrew，請先貼上這段指令並按下 Enter：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝完成後，接著透過 Homebrew 安裝負責處理影音轉檔的神兵利器 ffmpeg，以及下載開源社群開發的生成工具：

brew install ffmpeg
curl -L https://github.com/openclaw/openclaw/releases/latest/download/generate-media -o $HOME/bin/generate-media
chmod +x $HOME/bin/generate-media

記得確認 $HOME/bin 已經加入到你的系統路徑 (PATH) 中，這樣你才能在任何資料夾下直接呼叫這個神奇的指令哦！

3. 詳細解析：設定 HuggingFace Token 突破下載限制

在我們準備執行生成指令前，有一個非常關鍵的步驟必須處理：授權下載 AI 模型檔案。我們使用的 generate-media 工具，背後依賴的 AI 模型體積非常龐大（動輒超過 10GB 以上）。這些模型檔案通常託管在全球最大的 AI 開源社群平台 HuggingFace (簡稱 HF) 上。

為什麼需要設定 Token？
如果你以「未登入」的匿名訪客身分直接去 HuggingFace 伺服器抓取幾十 GB 的檔案，系統很容易因為流量安全防護機制，對你的 IP 進行「速率限制 (Rate Limit)」，導致下載速度慢如牛步，甚至中途斷線報錯。為了解決這個問題，我們需要向系統證明「我是有註冊的真實使用者」，這時就需要用到 HuggingFace Access Token (存取憑證)。

申請 Token 的步驟教學：

1. 註冊與登入： 前往 HuggingFace 官網，花個一分鐘註冊一組完全免費的帳號並登入（不需綁定信用卡，開源模型下載皆為 100% 免費使用）。
2. 前往設定頁面： 登入後，點擊網頁右上角你的個人頭像，在下拉選單中選擇 「Settings (設定)」，接著在左側選單找到 「Access Tokens」 選項（或是直接點擊這個 快捷連結）。
3. 建立新憑證： 點擊「New token」或「Create new token」按鈕。在彈出的視窗中，為你的 Token 隨便取個名字（例如：MacStudio_AI），重點在於 「Role (權限)」必須選擇「Read (讀取)」。我們只需要下載模型的權限，不需要賦予寫入權限，以確保帳號安全。
4. 複製憑證代碼： 建立完成後，你會得到一長串像是 hf_... 開頭的亂碼。點擊旁邊的複製按鈕把它存起來。這個代碼就像是一把專屬鑰匙，請妥善保管，不要隨意分享給他人。

如何將 Token 綁定到你的 Mac：

拿到這把「鑰匙」後，我們有兩種方式讓系統在下載模型時自動使用它。你可以根據自己的使用習慣選擇：

方法一：寫入系統設定檔（一勞永逸，最推薦）
如果你未來會頻繁使用 AI 生成工具，建議直接將 Token 存入 Mac 的終端機設定檔 (通常是 .zshrc)。請在終端機中執行以下指令（重要：請把下方指令中的 YOUR_TOKEN 替換成你剛剛複製的那串 hf_... 開頭的真實密碼）：

echo 'export HF_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
source ~/.zshrc

執行完畢後，你的 Mac 就已經將這把鑰匙記憶起來了！以後打開終端機，系統都會自動帶上這個憑證去下載所需檔案，暢通無阻。

方法二：單次臨時使用（適合偶爾測試）
如果你不想把 Token 寫死在系統設定裡，你也可以在每次執行生成指令時，把它當作環境變數臨時加在最前面。語法如下：

HF_TOKEN=YOUR_TOKEN generate-media video "你的提示詞..."

只要確實設定好 Token，你就能享受到全速下載模型的快感，大幅縮短第一次執行工具時的等待時間！

4. 實戰演練：產生 4K AI 影片

重頭戲來了！現在我們只要透過一行簡單的指令，就能召喚 AI 幫我們作畫拍片。我們將設定運算步數為 40 步（確保畫質精細度），開啟自動平鋪技術（auto tiling）來生成 4K 超大解析度，並將檔案輸出到桌面上。

在終端機輸入以下魔法指令：

generate-media video "一隻可愛小狗與小孩在公園快樂跳舞，陽光明亮，色彩鮮豔" --steps 40 --tiling auto -o $HOME/Desktop/puppy_child_dance.mp4

💡 執行過程小提醒：第一次執行這個指令時，系統會開始從網路下載高達 10GB 以上的模型檔案，由於我們在上一個步驟已經設定了 HuggingFace Token，下載過程應該會非常順暢，大約需要 10 到 15 分鐘。下載完畢後，後續每次生成就完全離線運作了！生成一段高畫質影片約需 1 到 2 小時。這段期間，你可以打開 Mac 的「活動監視器」，切換到「GPU」分頁，如果你看到使用率飆高，就代表你的 M2 Max 正在火力全開地為你創作！

5. 檢查與 ffmpeg 畫質優化

影片順利產出在桌面後，為了確保品質達到發布標準，我們可以用內建的 ffprobe 指令快速驗證檔案的健康度（包含時長與解析度）：

# 檢查影片時長
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 $HOME/Desktop/puppy_child_dance.mp4

# 檢查影片解析度
ffprobe -v error -select_streams v:0 -show_entries stream=width,height -of csv=p=0:s=x $HOME/Desktop/puppy_child_dance.mp4

如果發現輸出的檔案太小（例如小於 5 MiB），或者解析度沒有達到標準的 3840x2160，我們可以利用強大的 ffmpeg 進行最終的後製優化。以下指令會替影片進行高階降噪 (hqdn3d)、平滑放大縮放 (Lanczos 演算法) 並補幀至 60fps，讓影片看起來具備電影級的流暢感：

ffmpeg -i $HOME/Desktop/puppy_child_dance.mp4 -vf "hqdn3d,scale=3840:2160:flags=lanczos,fps=60" -c:v libx264 -crf 15 -preset slow -c:a copy $HOME/Desktop/puppy_child_dance_final.mp4

6. 常見問題與 FAQ