MiniMax · 影片

Hermes Agent x Hailuo

Hailuo 是 MiniMax 的影片模型,以原生 1080p 下準確的物理表現與動作擬真度著稱。透過 RunAPI,standard 與 pro 變體共用一組金鑰。

6 variants 起價 $0.50 / 次呼叫 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 hailuo-02-image-to-video-pro:1080p 以圖片為基準的影片;圖片作為首影格。

You have access to RunAPI task tools for Hailuo.

Available Hailuo models:
- hailuo-02-image-to-video-pro: 1080p 以圖片為基準的影片;圖片作為首影格
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-02-image-to-video-standard: 最高 768p 圖生影片;經濟方案
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-02-text-to-video-pro: 原生 1080p 文字生成影片輸出
  endpoints: /api/v1/hailuo/text_to_video
  request fields: model, prompt
- hailuo-02-text-to-video-standard: 最高 768p 文生影片;經濟方案
  endpoints: /api/v1/hailuo/text_to_video
  request fields: model, prompt
- hailuo-2.3-image-to-video-pro: 改善肢體動作、微表情與動漫/插畫風格
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url
- hailuo-2.3-image-to-video-standard: 同樣具備 2.3 的動作改進,解析度與成本較低
  endpoints: /api/v1/hailuo/image_to_video
  request fields: model, prompt, first_frame_image_url

Use the model ID and endpoint that match the user's request.
Example prompt: 生成一段 6 秒的片段:一顆玻璃彈珠滾過木桌,從桌緣掉落。
/api/v1/hailuo/image_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/hailuo/image_to_video,並儲存回傳的 Task ID。
GET /api/v1/hailuo/image_to_video/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。
/api/v1/hailuo/text_to_video: Submit the task, poll for its status, then verify the completed output. POST /api/v1/hailuo/text_to_video,並儲存回傳的 Task ID。
GET /api/v1/hailuo/text_to_video/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

公開版本與端點

模型 ID 端點 起始價格 模型目錄
hailuo-02-image-to-video-pro
/api/v1/hailuo/image_to_video
$0.57 / 次呼叫 模型詳情
hailuo-02-image-to-video-standard
/api/v1/hailuo/image_to_video
$0.50 / 次呼叫 模型詳情
hailuo-02-text-to-video-pro
/api/v1/hailuo/text_to_video
$0.57 / 次呼叫 模型詳情
hailuo-02-text-to-video-standard
/api/v1/hailuo/text_to_video
$0.50 / 次呼叫 模型詳情
hailuo-2.3-image-to-video-pro
/api/v1/hailuo/image_to_video
$0.90 / 次呼叫 模型詳情
hailuo-2.3-image-to-video-standard
/api/v1/hailuo/image_to_video
$0.50 / 次呼叫 模型詳情

驗證

輪詢,直到 Task 進入終態

選擇 <model-id> 後產生驗證命令。

設定

指南端點: <endpoint>

選擇 <model-id> 後,依端點的公開輸入契約產生請求。
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID,並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑,直到 Task 進入終態。

使用 Hermes Agent + Hailuo 可以打造什麼

  • 不露臉 YouTube 頻道內容

    為不露臉的 YouTube 頻道產生開場鏡頭和畫面序列,產出快、品質穩定。

  • 商品與電商短片

    製作物理效果逼真的商品影片,例如液體倒出、布料垂墜和物體旋轉。

  • 開場鏡頭與空景

    為較長的專案產生背景素材和轉場片段,環境、氛圍和運鏡都穩定可靠。

為什麼透過 RunAPI + Hermes Agent 使用 Hailuo

  • 6 個變體,一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體,無需變更現有整合。

  • 清楚的用量價格

    送出請求前查看目錄中的目前價格,無需訂閱或最低消費。

  • 自動化工作流程

    透過一致的工作流程提交工作、查詢狀態並收集非同步結果,無需撰寫手動輪詢程式碼。

Hermes Agent + Hailuo 常見問題

可以在 Hermes Agent 中使用 Hailuo 嗎?

可以。在 Hermes Agent 中將 RunAPI 設定為提供者,再呼叫本頁列出的 Hailuo 端點和版本。同一組 RunAPI API 金鑰可同時用於聊天和影片產生。

Hermes Agent 如何等待 Hailuo 影片完成?

Hailuo 是非同步的。API 會立即回傳任務 ID,你的 Hermes Agent 工作流程可以輪詢任務狀態,或提供 callback URL。

測試提示詞時如何避免浪費餘額?

調整提示詞階段先用成本較低的等級和較短的長度,最終產生時再切換到較高等級。

應該使用哪個模型 ID?

從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。

本指南會設定聊天模型嗎?

不會。此 Model Line 使用頁面所示的端點流程,不會被描述為 Agent 聊天模型。

開始在 Hermes Agent 中使用 Hailuo

正在與團隊一起打造?

我們可以協助企業接入、整合與技術問題。

聯絡我們