img_uuid,然後輪詢非同步任務或透過回呼處理狀態更新。GoEnhance 提供第三方存取,並非 MiniMax,也不是 MiniMax 官方 API。用於文字與圖片轉影片的 Hailuo 2.3 API
透過獨立的 GoEnhance API 存取 Hailuo 2.3。提交文字提示詞或加入第一影格圖片,接收
建立 API Key
選擇 Hailuo 2.3 生成模式
傳送生成請求前,請一併驗證模式、時長與解析度。
Hailuo 2.3 API 參數與驗證
模型與提示詞
將 <code>model</code> 設為 <code>hailuo_2_3</code>。每個請求都必須提供描述影片的文字 <code>prompt</code>。
可選的第一影格圖片
提供 <code>image_url</code> 以執行圖片轉影片;省略該欄位則為文字轉影片。該值必須是服務可存取的合法圖片 URL。
時長規則
<code>duration</code> 欄位接受 6 或 10 秒,預設為 6。1080P 請求僅支援 6 秒。
解析度選項
選擇 <code>768P</code> 或 <code>1080P</code>;預設為 768P。10 秒選項僅在 768P 下可用。
文字轉影片的畫面比例
文字轉影片請求可使用可選的 <code>ratio</code> 欄位。請勿將其用作第一影格圖片的覆寫機制。
非同步完成
提交成功後會回傳 <code>img_uuid</code>。請輪詢 <code>GET /api/v1/jobs/detail</code>,或提供 <code>custom_callback_url</code> 以接收狀態更新。
GoEnhance 所列的價格為每部影片、每個 token $0.02。提交前請選擇有效的解析度與時長組合。
Hailuo 2.3 API 計價
768P、6 秒 — 18.2 tokens ($0.364)
這是 Hailuo 2.3 API 所列完整影片請求的最低價格。
768P、10 秒 — 36.4 tokens ($0.728)
當應用程式需要 768P 下較長的支援時長時,請使用此方案。
1080P、6 秒 — 31.85 tokens ($0.637)
Hailuo 2.3 支援 1080P 的 6 秒影片;不支援 10 秒的 1080P 請求。
整合 Hailuo 2.3 API
1
1. 建立金鑰並建構請求
建立 API 金鑰,將其保存在伺服器上,並傳送 Bearer 驗證。將請求 POST 至
https://api.goenhance.ai/api/v1/videos/generations,並附上 model: hailuo_2_3、提示詞,以及有效的時長與解析度。 2
2. 儲存回傳的 img_uuid
將提交與生成視為不同階段。將回傳的
img_uuid 與你自己的任務記錄一起保存,如此重試與使用者工作階段才不會遺失任務識別。 3
3. 輪詢或處理回呼
輪詢
GET /api/v1/jobs/detail,或提供公開的 HTTPS 回呼網址。GoEnhance 會發布狀態變更,並在單次嘗試逾時三秒的情況下,對非 200 的回呼最多重試三次。在可重複提交與非同步交付比手動編輯更重要的情境下,使用此 API。
開發者使用 Hailuo 2.3 建置什麼
自動化廣告概念
將已核准的行銷活動提示詞轉為短影音候選項目,並將每個完成的素材路由至審核佇列。
商品圖片動畫
使用商品靜態圖作為第一個影格,建立可用於型錄、上市或簡報流程的動態片段。
編輯與社群媒體管線
整合結構化提示詞、非同步任務追蹤、回呼、審核與儲存,以支援可重複的短影音製作。
涵蓋模型輸入、Hailuo 2.3 API 費用、非同步任務、回呼,以及 MiniMax API 定位的解答。


