img_uuid，然後輪詢或接收 HTTPS 回呼以取得結果。用於影片生成的 HappyHorse 1.1 API
透過獨立的 GoEnhance 開放 API 存取 HappyHorse 1.1 API，以進行文字轉影片、首幀圖像轉影片，或獨立的參考圖像工作流程。提交非同步任務，儲存回傳的
建立 API 金鑰
選擇正確的 HappyHorse API 模式
首幀影像轉影片
新增 image_url 以對首幀進行動畫處理。影像必須為 JPEG、PNG 或 WEBP 格式，尺寸至少 300px，檔案小於 10MB，且比例需在 1:2.5 至 2.5:1 的規範範圍內。
參考影像影片
使用 model: happyhorse-1-1-ref 並在 image_urls 中提供 1–9 個網址。在提示詞中分別以 [Image 1]、[Image 2] 等標記引用每個來源。
在將工作發送到生產佇列之前，請先驗證所選的請求模式。
HappyHorse 1.1 API 功能與限制
兩種標準輸入模式
僅使用提示詞進行文字轉影片，或新增一個 <code>image_url</code> 進行首幀影像轉影片。
獨立多參考模型
使用 <code>happyhorse-1-1-ref</code> 並搭配 1–9 個必要的參考影像網址；此模式不支援純文字轉影片。
3–15 秒時長
將 <code>duration</code> 設定為 3 到 15 秒之間的整數。預設值為 5 秒。
720p 或 1080p 輸出
選擇 <code>720p</code> 或 <code>1080p</code>。預設值為 <code>720p</code>。
直式、方形與橫式比例
標準路徑支援 16:9、9:16、1:1、4:3 與 3:4。參考模式另支援 4:5 與 5:4。
輪詢與回呼
保留 <code>img_uuid</code>，輪詢工作詳情端點，或提供公開的 HTTPS 回呼網址以接收狀態更新。
GoEnhance 將每秒定價記錄為每個 Token $0.02，目前將這些費率標記為限時優惠。
HappyHorse 1.1 API 定價
720p：每秒 $0.104
720p 生成每秒消耗 5.2 個代幣。5 秒的請求消耗 26 個代幣，依據記錄的換算匯率為 $0.52。
1080p：每秒 $0.144
1080p 生成使用每秒 7.2 個 Token，相當於每生成一秒 $0.144。
按時長估算
將所選的每秒費率乘以要求的 3–15 秒時長。由於促銷價格可能會變動，請在進行生產批次處理前查看即時 API 參考文件。
整合 HappyHorse 1.1 API
1
1. 建立並保護 API 金鑰
建立一個 GoEnhance 金鑰，並透過受信任的伺服器端程式碼以 Bearer 授權方式發送。
2
2. 選擇模型
選擇
happyhorse-1-1 進行純提示詞或首幀生成，或選擇 happyhorse-1-1-ref 進行 1–9 張參考圖像生成。 3
3. 建立並驗證負載
提供所需的提示詞，然後針對所選模式驗證圖像欄位、時長、解析度、比例和回調 URL。
4
4. 提交影片任務
POST 至
https://api.goenhance.ai/api/v1/videos/generations 並儲存回傳的 img_uuid。 5
5. 追蹤狀態
輪詢
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... 或透過公開的 HTTPS 回調接收狀態變更。 6
6. 處理終端結果
以冪等方式處理成功與失敗結果，驗證回傳的資產，並避免在輪詢與回調重疊時產生重複的下游工作。
將結構化生成請求連接至審核、儲存與交付工作流程。
HappyHorse API 的開發者使用案例
廣告活動影片變體
從結構化提示詞生成短動態概念，以供創意審核與下游編輯使用。
產品與品牌動態
在您的後端控制時長、解析度與完成處理的同時，為已核准的首幀進行動畫製作。
角色互動研究
使用參考模型來描述已核准來源圖像中的主體應如何在同一場景中呈現。
分鏡腳本預覽
在投入更大規模的製作流程之前，將鏡頭描述轉化為可供審核的短片。
在地化創意管線
將區域變體的提示詞參數化，同時保持任務提交與監控的一致性。
自動化資產佇列
在後端服務中連接生成、任務狀態持久化、回調、儲存與人工審核。
關於定價、請求模式、輸入限制與非同步任務處理的解答。