OpenClip：UGC 廣告生成
generate_ugc 能根據創意簡報渲染出一段短直式 UGC 風格短片（約 7 到 12 秒）。免費帳戶每天只能生成一次。付費帳戶則按渲染秒數以點數計費。
渲染過程較耗資源，預計需要幾分鐘而非幾秒鐘才能完成一段短片。
設定（一次性）
OpenClip 是一個遠端 MCP 伺服器，位於 https://openclip.app/mcp。當 OAuth 提示出現時，請使用您的 OpenClip 帳號登入，無需複製任何 API 金鑰。
- Claude Code：
claude mcp add --transport http openclip https://openclip.app/mcp，然後使用/mcp進行授權。 - Claude Desktop / 網頁版： 開啟「設定」，點選「連接器」，選擇「新增自訂連接器」，貼上 URL 並登入。
- Cursor（
.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } } - 僅支援標頭的客戶端： 在
openclip.app/settings/connect產生一個 MCP 權杖，然後連接到https://openclip.app/mcp/key，標頭為Authorization: Bearer <token>。
進行基本檢查：呼叫 get_account。
工作流程
- 先查閱創作者名單。
list_ugc_creators會回傳此團隊有效的creator和start_frame值：包括精選名單以及團隊自己儲存的創作者，並按領域分組。切勿憑空猜測創作者名稱，請從此呼叫結果中選取。 - **生成影片。**使用
generate_ugc(...)並提供以下其中一種參數：brief_name－ 伺服器端預設的快速路徑，或brief－ 包含結構化創意欄位（如character等）的內嵌物件。
- **輪詢進度。**函式會回傳一個
ugc_job的 hashid。每 10 到 15 秒輪詢一次get_ugc_job_status(ugc_job)。queued或rendering表示仍在處理中，completed會回傳video_url及result_meta（包含時長、尺寸、FPS、種子碼），failed則回傳error。 - 回顧過去作品。
list_ugc_jobs會列出團隊先前的 UGC 短片，若您遺失了ugc_job的 id，可透過此函式找到它再進行輪詢。
創意簡報必須是結構化資料，而非連續敘述
這是代理最容易犯錯的地方。brief 不是一段連續的文字提示。它是一個由離散創意欄位（character 及其他 API 接受的欄位）組成的物件。若將一整段文字塞入單一欄位，會浪費結構化設計並產出模糊的結果。
請為每個欄位填寫具體、可視覺化、可拍攝的細節：
- 描述畫面中的物件，而非應該傳達的感覺。「將瓶子舉在胸前高度，身後是廚房流理台」比「充滿活力與抱負的氛圍」更好。
- 每個欄位只放一個想法。不要將三個橋段塞入
character中。 - 具體的限制能產出比形容詞更好的結果。一個明確的場景、一個明確的道具、一個明確的動作，勝過「高品質、專業、引人入勝」。
測試廣告角度
當使用者想要多種變化而非單一段影片時，每次渲染只改變一個變數，這樣比較才有意義：
- 相同創作者，不同鉤子。
- 相同鉤子，不同創作者（當您在測試誰能更好地傳達訊息時）。
- 其他條件相同，不同
start_frame（當您在測試縮圖的關鍵時刻時）。
免費帳戶每天只能生成一次，因此在免費帳戶上，請將這唯一一次的機會用在最具差異性的角度上，而不是近乎重複的版本。在承諾批次生成前，請先檢查 get_account。
規則
- 每次工作階段中的首次生成前，務必先執行
list_ugc_creators。名單是依團隊而異且會變動的。 - 務必輪詢。渲染需要數分鐘，
generate_ugc會立即回傳。 - 短片預設長度較短，約 7 到 12 秒。請勿承諾 60 秒的廣告。
- 免費帳戶每天只能生成一次。請在用戶計畫於免費帳戶上進行批次生成前說明此限制。
result_meta中包含seed。當用戶喜歡某次渲染並想要相近的變體時，請保留此種子碼。
錯誤處理
工具失敗時會以 isError: true 及純文字訊息回傳，而非 HTTP 狀態碼。若收到 `