如何使用 HappyHorse 1.1 API

精選摘要解答

HappyHorse 1.1 是 Alibaba 升級的 AI 影片生成模型家族，可從文字提示、首幀圖片或多張參考圖片生成短影片。透過 CometAPI，開發者可從統一影片端點呼叫 HappyHorse 1.1，建立非同步影片任務、輪詢任務狀態，並下載完成的 MP4。建議流程為：建立 CometAPI 金鑰，確認如 happyhorse-1.1 的線上模型 ID，提交含提示詞、時長與解析度的 POST /v1/videos 任務，輪詢 GET /v1/videos/{task_id}，最後永久儲存回傳的影片檔。Public Artificial Analysis 數據目前將 HappyHorse-1.1 排名為具音訊的文字轉影片第 2、以及具音訊的圖片轉影片第 2，僅次於 Dreamina Seedance 2.0 720p。從 HappyHorse 1.0 遷移的團隊應將新的 T2V、I2V 與 R2V 生成工作負載移至 1.1，但在有經過測試的替代方案前，保留 1.0 的影片編輯路由。

為何 HappyHorse 1.1 會改變 2026 年的 AI 影片格局

在快速演進的生成式 AI 版圖中，Alibaba 的 HappyHorse 1.1 脫穎而出，成為 2026 年頂尖的 AI 影片模型之一。建立在HappyHorse 1.0 的匿名成功（其在 2026 年 4 月稱霸 Artificial Analysis Video Arena）之上，1.1 版帶來更強的動作表現力、更優的主體一致性、原生同步音訊與零漂移口型、更好的長上下文指令遵循，以及全新的影片編輯模態。

無論你是製作電商廣告的內容創作者、做分鏡原型的電影人、打造品牌微劇的行銷人，或是在 App 中整合影片的開發者，HappyHorse 1.1 都能輸出可投入製作的 720P 或 1080P 成果，時長 3 至 15 秒。

直接透過阿里雲存取可能牽涉區域性複雜度與設定開銷。CometAPI 大幅簡化了這一切，作為通往 500+ 個 AI 模型的統一閘道（包含 HappyHorse 1.1），提供與 OpenAI 相容的端點、具競爭力的價格、高可用性與易整合性。本指南聚焦透過 CometAPI 使用，以實現順暢且具成本效益的工作流程。

什麼是 HappyHorse 1.1？

HappyHorse 1.1 是 Alibaba（透過 ATH/Alibaba Cloud Model Studio）的次世代統一多模態影片合成模型。它在單一串流中處理文字、視覺與音訊 token，採用 ~15B 參數架構（由 1.0 演進而來），實現具規劃性的連貫輸出，而非後期拼接片段。

主要能力：

• Text-to-Video (T2V)： 直接由描述性提示詞生成影片。
• Image-to-Video (I2V)： 以首幀圖片為基礎進行動畫化，並可選擇加入動作引導。
• Reference-to-Video (R2V)： 使用最多 9 張參考圖片，以確保風格、角色或環境的一致性。
• 影片編輯： 1.1 新增—以提示詞與參考圖片編輯現有影片（如風格遷移、服裝更換）。
• 原生音訊與口型同步： 支援多語（英語、普通話等），具情境感知的語速與低 Word Error Rate。
• 輸出規格： 720P/1080P、彈性長寬比、3–15 秒時長、含同步音訊的 MP4。

API docs 說明影片任務的生成時間為 1 至 5 分鐘、先建立任務再輪詢結果的流程、PENDING、RUNNING、SUCCEEDED、FAILED 等任務狀態，以及在到期前必須下載的結果 URL。這意味著 HappyHorse 1.1 並非像同步聊天機器人那樣使用。它應置於媒體工作流程中，包括任務記錄、進度 UI、重試、中繼資料擷取與可持久儲存。

效能基準：HappyHorse 1.1 有多強？

影片模型的基準測試比文字更難，因為用戶同時評估動作、連貫性、提示詞遵循、影像保真度、音訊、口型同步、鏡頭風格、物理效果與美學。不過，公開的偏好排行榜仍有助於在你執行自家提示詞套件前先篩選模型。

截至為本文查閱的 2026 年 6 月 29 日最新公開 Artificial Analysis 快照，HappyHorse-1.1 是公開競技場中最強的具音訊 AI 影片模型之一。在具音訊的文字轉影片排行榜上，Dreamina Seedance 2.0 720p 以 Elo 1,219 領先，HappyHorse-1.1 以 Elo 1,151 居次，HappyHorse-1.0 以 Elo 1,123 排第三。在具音訊的圖片轉影片方面，Dreamina Seedance 2.0 720p 以 Elo 1,194 領先，HappyHorse-1.1 以 Elo 1,117 第二，grok-imagine-video-1.5-preview 以 Elo 1,110 第三，Wan 2.7 以 Elo 1,090 第四，HappyHorse-1.0 以 Elo 1,089 第五。

無音訊類別提供了更多細節。Artificial Analysis 目前列出 HappyHorse-1.0 在無音訊的文字轉影片略高於 HappyHorse-1.1，其中 HappyHorse-1.0 為 Elo 1,290、HappyHorse-1.1 為 Elo 1,285。對於無音訊的圖片轉影片，Dreamina Seedance 2.0 720p 以 Elo 1,343 領先，而 HappyHorse-1.1 以 Elo 1,311 排第五。

基準快照

務實的結論不是 HappyHorse 1.1 在每個類別都勝出，而是它是具音訊短影片的嚴肅生產候選，尤其當參考一致性與視覺可控性很重要時。若你使用 CometAPI 構建，請用自家的提示詞、品牌資產、審查標準與預算，將 HappyHorse 1.1 與 Seedance、Wan、Kling、Veo、Sora 類路由以及 HappyHorse 1.0 進行對比基準。

HappyHorse 1.1 與替代方案比較

先決條件

在透過 CometAPI 呼叫 HappyHorse 1.1 前，請準備：

1. CometAPI 帳戶與 API 金鑰。
2. 後端執行環境，如 Node.js、Python、Go、PHP，或無伺服器函式。
3. 伺服器端環境變數，例如 COMETAPI_KEY。
4. 目標工作流程：文字轉影片、圖片轉影片或參考轉影片。
5. 以鏡頭概要撰寫的提示詞，而非鬆散字幕。
6. 可選的首幀或參考圖片（公開 HTTPS URL 託管，或依 CometAPI 活躍路由上傳）。
7. 目標時長，通常為 3、5、10 或 15 秒。
8. 目標解析度，測試用 720p，最終資產用 1080p。
9. 用於 task_id、使用者 ID、提示詞、模型、參數、狀態、成本預估與輸出 URL 的資料庫資料表或任務儲存。
10. 用於已完成 MP4 檔案的持久儲存，因為生成結果 URL 可能是暫時性的。
11. 對 429、逾時與上游暫時性故障的重試邏輯。
12. 面對供應商中斷、政策邊界個案、延遲飆高或成本變動的備援模型計畫。

CometAPI 的價值在於集中管理模型存取、憑證、計費可視化與模型切換。對於生產級影片應用，這可減少你需要維護的供應商特定程式碼。

如何在 CometAPI 使用 HappyHorse 1.1 API

實際的模型目錄與參數結構可能演進，因此在部署前請核對線上 CometAPI 模型頁與 API 文件。實務模式穩定：建立影片任務、輪詢任務、下載並儲存最終 MP4。

步驟 1：儲存你的 API 金鑰

切勿在瀏覽器 JavaScript、行動應用程式、公開 GitHub 儲存庫或客戶端日誌中暴露 CometAPI 金鑰。請在伺服器端儲存：

export COMETAPI_KEY="your_cometapi_key"

在生產環境中，使用 AWS Secrets Manager、Google Secret Manager、Azure Key Vault、Doppler、Infisical 或你的平台加密環境變數存放等秘密管理服務。

步驟 2：確認模型 ID

對 CometAPI 範例，請使用線上目錄顯示的公開模型 ID。常見的 HappyHorse 1.1 模型 ID 為：

happyhorse-1.1

Alibaba 的直連 API 會暴露特定模式的 ID，如 happyhorse-1.1-t2v、happyhorse-1.1-i2v 與 happyhorse-1.1-r2v。CometAPI 可能在單一影片模型 ID 背後簡化，或暴露特定路由變體。上線前請檢查 CometAPI 模型目錄，不要在生產硬編碼未核對的流量。

步驟 3：建立文字轉影片任務

僅有文字創意簡報時使用此方式。

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=happyhorse-1.1" \  -F "prompt=A 7-second vertical ecommerce video for a matte black smart speaker on a marble kitchen counter. The camera slowly dollies in from a three-quarter angle. Warm morning sunlight, soft reflections, tiny dust particles, premium consumer electronics commercial style. Native ambient room tone, subtle startup chime, no extra text, keep the speaker shape consistent." \  -F "seconds=7" \  -F "size=720x1280"

若你的 CometAPI 控制台顯示使用 resolution 與 aspect_ratio 而非 size，請使用當前結構，例如：

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=happyhorse-1.1" \  -F "prompt=A cinematic close-up of a glass perfume bottle on black stone, slow macro push-in, gold rim light, faint mist, elegant piano notes, label remains readable." \  -F "seconds=5" \  -F "resolution=720p" \  -F "aspect_ratio=16:9"

回應應回傳任務識別碼。請立即儲存：

{  "id": "task_example",  "task_id": "task_example",  "object": "video",  "model": "happyhorse-1.1",  "status": "queued",  "progress": 0,  "created_at": 1779938152}

步驟 4：建立圖片轉影片任務

當你有經核准的首幀，例如產品渲染、時尚照片、App 截圖、角色肖像或設計模型時使用圖片轉影片。提示詞應描述動作，而非重述圖片中可見的一切。

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=happyhorse-1.1" \  -F "prompt=Animate the uploaded product photo into a 5-second premium product reveal. Keep the product color, shape, logo, and label unchanged. Add a slow clockwise camera orbit, soft studio highlights, gentle background movement, and subtle ambient sound. No new text or extra objects." \  -F "image_url=https://example.com/assets/smart-speaker-first-frame.png" \  -F "seconds=5" \  -F "size=1280x720"

對於首幀圖片工作流程，請使用乾淨的來源圖片。Alibaba 的圖片轉影片文件列出支援 JPEG、JPG、PNG 與 WEBP，最大 20 MB，寬高至少 300 像素，長寬比介於 1:2.5 與 2.5:1。即便 CometAPI 代你處理供應商細節，品質不佳的來源圖片仍會產生品質不佳的輸出。

步驟 5：建立參考轉影片任務

當身分（辨識度）很重要時使用參考轉影片。這是品牌吉祥物、常駐角色、時尚造型、產品包裝、道具、房間、車輛或必須保持可辨識場景的正確模式。

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=happyhorse-1.1" \  -F "prompt=[Image 1] is the exact red running shoe. [Image 2] is the athlete. Create an 8-second vertical sports ad: the athlete ties the shoe, steps onto wet pavement, then sprints through a neon-lit city street. Low-angle tracking shot, realistic splash physics, energetic drum rhythm, keep the shoe color and side logo visible throughout." \  -F "reference_image_urls[]=https://example.com/assets/red-shoe.png" \  -F "reference_image_urls[]=https://example.com/assets/athlete.png" \  -F "seconds=8" \  -F "size=720x1280"

Alibaba 的參考轉影片文件允許 1 至 9 張參考圖片，並建議在提示詞中以 [Image 1]、[Image 2] 等方式引用，順序需與媒體陣列一致。即使透過 CometAPI 呼叫，這也是個好習慣，可讓創作指令更不含糊。

步驟 6：輪詢任務

影片生成是非同步的。請輪詢直到任務達到終態：

curl https://api.cometapi.com/v1/videos/{task_id} \  -H "Authorization: Bearer $COMETAPI_KEY"

生產環境的輪詢器應使用合理間隔（如 10 至 15 秒），並應在符合產品體驗的逾時後停止。將最新狀態寫入資料庫，讓使用者重新整理頁面時不會遺失進度。

步驟 7：下載完成的 MP4

狀態完成後，下載內容：

curl https://api.cometapi.com/v1/videos/{task_id}/content \  -H "Authorization: Bearer $COMETAPI_KEY" \  -o happyhorse-1-1-output.mp4

不要將暫時性的供應商 URL 當作永久資產連結。請下載 MP4，上傳至你的儲存桶，附加中繼資料，並透過自家 CDN 或媒體服務提供。

HappyHorse 1.1 API 要花多少錢？

阿里雲 Model Studio 的定價頁面以輸出時長列出 HappyHorse 1.1 的影片生成價格。在新加坡，HappyHorse 1.1 的價格為 720P $0.14/sec、1080P $0.18/sec。在美國（維吉尼亞）與德國（法蘭克福），Alibaba 列出 720P $0.123769/sec 與 1080P $0.165026/sec。同表中 HappyHorse 1.0 的 1080P 價格更高，這讓 1.1 對需要輸出最終 1080P 片段的團隊更具吸引力。

CometAPI 公開價格的成本範例

CometAPI 的 Happy Horse 1.1 模型 720p 生成為 $0.112/sec，1080p 生成為 $0.144/sec，相較官方 720p 價格 $0.14/sec，約為 8 折。

更好的生產指標不僅是每次生成的成本。追蹤每支通過審核的影片成本。若一支 5 秒 720p 的草稿成本為 $0.56，但你需要重試 8 次，則通過審核的影片在審核與存儲前的成本為 $4.48。若更好的提示詞或更強的參考圖片將重試次數從 8 次降至 3 次，成本改進

更好的生產指標不僅是每次生成的成本。追蹤每支通過審核的影片成本。若一支 5 秒 720p 的草稿成本為 $0.56，但你需要重試 8 次，則通過審核的影片在審核與存儲前的成本為 $4.48。若更好的提示詞或更強的參考圖片將重試次數從 8 次降至 3 次，則其成本改善幅度遠大於模型間的小幅價差。

建議的 CometAPI 成本策略：

1. 先以 720p 與短時長產生初稿。
2. 每個提示詞家族產生 3 至 5 個變體。
3. 用一致的量表評分輸出物。
4. 將勝出提示詞提升到 1080p。
5. 保存所有提示詞、參考圖片、模型 ID、若有則種子、任務 ID、成本預估與審核決策。
6. 以每件通過資產的成本，比較 HappyHorse 1.1 與替代方案。

HappyHorse 1.0 遷移指南

多數團隊不應一夜之間把所有請求切到 1.1。請採分階段計畫。

從 1.0 到 1.1 有哪些改變？

遷移清單

1. 匯出你在 HappyHorse 1.0 的前 20–50 個提示詞。
2. 依工作流程分組：T2V、I2V、R2V 與影片編輯。
3. 將相同提示詞、時長、解析度與參考圖片跑過 HappyHorse 1.1。
4. 以提示詞遵循度、動作品質、主體保真、音訊實用性、偽影率、品牌安全與成本評分。
5. 對於 1.0 仍勝出或需要影片編輯的提示詞，保留 1.0。
6. 在 1.1 提升通過率的地方，將新生成工作流程移至 1.1。
7. 更新提示詞模板，使約束更清晰並加入參考標籤。
8. 在後端加入模型路由，使 happyhorse-1.0、happyhorse-1.1 與替代方案可依工作類型選擇。
9. 監控失敗率、平均生成時間、每支通過影片成本與審核退回原因。
10. 依專案、客群或媒體類型逐步推行。

向後相容的路由範例

function chooseVideoModel(job) {
  if (job.type === "video_edit") {
    return "happyhorse-1.0";
  }

  if (job.requiresCustomAudio || job.needsFirstLastFrameControl) {
    return "wan2.7";
  }

  if (job.hasReferenceImages || job.requiresBrandConsistency) {
    return "happyhorse-1.1";
  }

  if (job.isBenchmarkExperiment) {
    return job.experimentalModel ?? "happyhorse-1.1";
  }

  return "happyhorse-1.1";
}

這使遷移可逆。若某個模型路由變更，你只需更新路由，而非重寫產品程式碼。

常見錯誤與最佳實務

立即保存輸出

暫時性的結果 URL 會過期。你的工作器應在任務成功後立即下載最終 MP4，並上傳到你自己的儲存中。

驗證影像輸入

在送往 API 前拒絕過小、模糊、壓縮嚴重或長寬比錯誤的影像。對於 R2V，盡可能使用每張僅有一個明顯主體的乾淨參考。

在工作流程中建立人工審核

AI 影片具機率性。即使強大的模型也會產生偽影。生產系統需要審核狀態、退回原因與再生成控制。

保留來源中繼資料

保存原始提示詞、正規化提示詞、模型 ID、圖片 URL、任務 ID、時長、解析度、成本預估、輸出 URL、永久資產 URL、審核人與決策。這份資料集會成為你的內部基準。

結語：立即在 CometAPI 上用 HappyHorse 1.1 開始打造

HappyHorse 1.1 代表可近用、高品質 AI 影片的一大飛躍。透過 CometAPI，整合簡單、具成本效益且強大。註冊、取得金鑰並在 Playground 試驗——你的下一支爆款影片或廣告活動只差幾秒。

行動呼籲： 造訪 CometAPI 取得免費點數、完整文件與 500+ 模型。分享你的創作，加入推動 AI 影片邊界的社群。

關於 HappyHorse 1.1 的常見問題

什麼是 HappyHorse 1.1？

HappyHorse 1.1 是 Alibaba 升級的 AI 影片生成模型家族，可從文字提示、首幀圖片或多張參考圖片生成短影片。它針對 3 至 15 秒的短片設計，輸出 720P 或 1080P，並具備音訊與影片的同時生成。

HappyHorse 1.1 能透過 CometAPI 使用嗎？

可以。CometAPI 在其模型與定價頁列出 Happy Horse 1.1，並提供統一的影片生成 API。部署前請在 CometAPI 線上目錄確認目前的模型 ID、狀態、支援參數與依解析度區分的價格。

我應該使用哪個模型 ID？

在 CometAPI 請使用線上目錄值，常見為 happyhorse-1.1。Alibaba 直接的 Model Studio API 會使用模式專屬 ID：happyhorse-1.1-t2v、happyhorse-1.1-i2v 與 happyhorse-1.1-r2v。

HappyHorse 1.1 支援參考圖片嗎？

支援。1 至 9 張參考圖片。在提示詞中以 [Image 1]、[Image 2] 等方式引用，並與媒體陣列順序一致。

HappyHorse 1.1 生成影片需要多久？

一般影片任務時間為 1 至 5 分鐘。實際延遲會因時長、解析度、佇列負載、路由與供應商可用性而異。

HappyHorse 1.1 在 CometAPI 上要多少錢？

CometAPI 公開的 Happy Horse 1.1 價格為 720p $0.112/sec、1080p $0.144/sec。請務必在控制台核對即時價格，因為影片價格可能因解析度、路由、區域與促銷而變動。

我應該用 HappyHorse 1.1 還是 HappyHorse 1.0？

對於新的 T2V、I2V 與 R2V 測試，當需要更平順的動作、更好的提示詞遵循、音畫品質與參考一致性時，請使用 HappyHorse 1.1。對已表現良好的舊提示詞與影片編輯路由，請保留 HappyHorse 1.0，直到你測試出替代方案為止。