用於文字與圖片轉影片的 Hailuo 2.3 API

透過獨立的 GoEnhance API 存取 Hailuo 2.3。提交文字提示詞或加入第一影格圖片,接收 img_uuid,然後輪詢非同步任務或透過回呼處理狀態更新。GoEnhance 提供第三方存取,並非 MiniMax,也不是 MiniMax 官方 API。
建立 API Key
說明 Hailuo 2.3 API 生成的電影級影片製作場景。

選擇 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

1. 建立金鑰並建構請求

建立 API 金鑰,將其保存在伺服器上,並傳送 Bearer 驗證。將請求 POST 至 https://api.goenhance.ai/api/v1/videos/generations,並附上 model: hailuo_2_3、提示詞,以及有效的時長與解析度。
2. 儲存回傳的 img_uuid
2

2. 儲存回傳的 img_uuid

將提交與生成視為不同階段。將回傳的 img_uuid 與你自己的任務記錄一起保存,如此重試與使用者工作階段才不會遺失任務識別。
3. 輪詢或處理回呼
3

3. 輪詢或處理回呼

輪詢 GET /api/v1/jobs/detail,或提供公開的 HTTPS 回呼網址。GoEnhance 會發布狀態變更,並在單次嘗試逾時三秒的情況下,對非 200 的回呼最多重試三次。
在可重複提交與非同步交付比手動編輯更重要的情境下,使用此 API。

開發者使用 Hailuo 2.3 建置什麼

自動化廣告概念

將已核准的行銷活動提示詞轉為短影音候選項目,並將每個完成的素材路由至審核佇列。

商品圖片動畫

使用商品靜態圖作為第一個影格,建立可用於型錄、上市或簡報流程的動態片段。

編輯與社群媒體管線

整合結構化提示詞、非同步任務追蹤、回呼、審核與儲存,以支援可重複的短影音製作。
涵蓋模型輸入、Hailuo 2.3 API 費用、非同步任務、回呼,以及 MiniMax API 定位的解答。

Hailuo 2.3 API 常見問題

開始整合 Hailuo 2.3 API

Hailuo 2.3 API 計價與整合 | GoEnhance