前言¶

在 Agent 裏做視頻生成時，常見做法是臨時拼一段 HTTP 腳本：處理鑑權、輪詢 task_id、判斷成功失敗。接口字段、鑑權前綴、任務狀態各寫各的，時間一長容易和 MiniMax-H3、Seedance 的調用混在一起。zhishu-happyhorse 把 HappyHorse 的生成任務單獨封裝成一個 skill，讓 Agent 能按統一入口調用。

這是什麼¶

zhishu-happyhorse 是一個獨立 skill，用於調用 zhishuai.net 的 HappyHorse 視頻生成 API。它覆蓋文生視頻、首幀圖生視頻、參考生視頻三種模式，並圍繞 task_id 提供查詢、等待、取消能力。

發佈者是中視雲逸，來源爲 enterprise，分類是 design-media，當前版本 1.0.4。SkillHub 頁面顯示評分 100000、下載 1039、安裝 0，標籤 contains requires_api_key=true。

核心功能¶

該 skill 提供四個 Python 標準庫腳本，職責如下：

create_video.py    創建視頻生成任務
query_video.py     按 task_id 查詢任務狀態
wait_video.py      等待任務完成
cancel_video.py    取消任務

create_video.py 覆蓋三種生成模式：文生視頻、首幀圖生視頻、參考生視頻。鑑權時自動在 API Key 前加 Bearer 前綴。它被設計爲獨立 skill，不與 MiniMax-H3 / Seedance 混用。

安裝與啓用¶

調用該 skill 需要先準備好 HappyHorse 的 API Key。已抓取資料裏沒有出現官方安裝命令、目標目錄和配置字段，這裏不虛構。啓用方式以 SkillHub 官方頁面爲準。

典型用法¶

已抓取資料沒有給出完整可復現的命令示例，因此這裏只列官方資料中已覈實的觸發場景，不編造參數和返回值。

用戶觸發詞包括：

用 happyhorse 生成
首幀圖生
參考視頻
查 happyhorse 任務
取消 happyhorse

Agent 收到這些表達後，應優先判斷用戶要的是創建任務、查詢任務還是取消任務，再走對應腳本。

適用場景與注意¶

適合需要在 Agent 中統一調用 HappyHorse 視頻生成，並處理任務生命週期的開發者。它可以把“創建—查詢—等待—取消”這條鏈路固化下來，減少每次臨時寫接口的成本。

需要留意的點：

• 依賴 zhishuai.net 的 HappyHorse 視頻生成 API，調用前要確認 API Key 可用。
• 官方示例、請求字段、輪詢間隔、錯誤碼和限流規則在已抓取資料中沒有出現，使用前以官方文檔爲準。
• 不要拿它替代 MiniMax-H3 / Seedance 的調用邏輯。

結尾¶

zhishu-happyhorse 的價值在於把 HappyHorse 的三種生成模式和 task_id 生命週期固化成四個標準庫腳本，降低在 Agent 裏臨時對接的成本。

官方地址：https://api.skillhub.cn/org-gydw2je6/zhishu-happyhorse