---
title: "透過 RunAPI 在 OpenClaw 中使用 Hailuo — 影片 API 指南"
url: "https://runapi.ai/zh-HK/openclaw-hailuo.md"
canonical: "https://runapi.ai/zh-HK/openclaw-hailuo"
locale: "zh-HK"
model: "hailuo"
---

# 在 OpenClaw 中使用 Hailuo。

Hailuo 是 MiniMax 的影片生成模型，可產出原生 1080p 畫面並精準模擬物理效果，共有 6 種變體 — Hailuo 02 與 2.3，各具備文生影片與圖生影片端點，分 pro 與 standard 兩個方案。OpenClaw agent 透過 RunAPI 呼叫，與聊天共用同一個 API key。

## API example

```bash
curl -X POST https://runapi.ai/api/v1/hailuo/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-02-text-to-video-pro",
    "prompt": "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field."
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "hailuo-02-text-to-video-pro"
}

```

## How it works

1. **設定 RunAPI** — 設定 RUNAPI_API_KEY 環境變數。如果你已在 OpenClaw 中設定 RunAPI 作為聊天 provider，同一把 key 即可用於影片生成 — 無需額外設定。
2. **呼叫 Hailuo text_to_video 或 image_to_video** — 向 /api/v1/hailuo/text_to_video 發送 POST 請求，將 model 設為 hailuo-02-text-to-video-pro 並附上描述場景的 prompt。若要以圖片為錨點生成影片，使用 image_to_video 端點並傳入 first_frame_image_url 以保留來源主體。
3. **輪詢結果** — 端點會立即回傳 task_id。輪詢任務狀態端點，直到狀態變為 completed，再從回應中取得生成的影片 URL。pro 方案的典型處理時間在兩分鐘以內。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。可選值：hailuo-02-text-to-video-pro、hailuo-02-text-to-video-standard、hailuo-02-image-to-video-pro、hailuo-02-image-to-video-standard、hailuo-2.3-image-to-video-pro、hailuo-2.3-image-to-video-standard。 |
| `prompt` | `string` | 必填。影片場景、鏡頭運動與燈光的文字描述。 |
| `first_frame_image_url` | `string` | image_to_video 端點必填。作為第一幀的來源圖片 URL。 |
| `last_frame_image_url` | `string` | 選填。作為最後一幀的圖片 URL。僅適用於 Hailuo 02 image-to-video。 |
| `duration_seconds` | `integer` | 選填。影片長度（秒）。可選值：6 或 10。standard 預設為 10，pro 固定。 |
| `output_resolution` | `string` | 選填。輸出解析度。02 standard 可選 512p 或 768p；2.3 變體可選 768p 或 1080p。 |
| `callback_url` | `string` | 選填。任務完成時接收 POST 通知的 Webhook URL。 |

## FAQ

### Hailuo 02 與 Hailuo 2.3 有什麼差別？

Hailuo 02 同時支援文生影片與圖生影片，具備首幀與末幀控制。Hailuo 2.3 僅支援圖生影片，但新增了改進的身體動態、微表情，以及 02 中不具備的動漫與插畫專用渲染風格。

### 我可以同時設定影片的首幀與末幀嗎？

可以，但僅限 Hailuo 02 image-to-video 端點。同時傳入 first_frame_image_url 與 last_frame_image_url 即可。Hailuo 2.3 image-to-video 僅接受 first_frame_image_url。

### pro 與 standard 的計費方式有何不同？

Hailuo 02 Pro 文生影片每次生成固定收費 57 美分，不受時長影響。Standard 採用時長計費 — 6 秒 30 美分、10 秒 50 美分。image-to-video standard 的價格還會受 output_resolution 影響。

### Hailuo 是非同步還是同步？

非同步。API 會立即回傳 task_id。輪詢任務狀態端點或設定 callback_url 以在影片就緒時接收 Webhook 通知。典型生成時間為 60-120 秒。

### Hailuo 輸出什麼解析度？

Hailuo 02 Pro 輸出原生 1080p。Standard 根據 output_resolution 參數輸出 512p 或 768p。Hailuo 2.3 變體支援 768p 或 1080p。不進行後處理放大。


## Links

- [OpenClaw 設定指南 →](https://runapi.ai/zh-HK/openclaw)
- [Hailuo 模型 →](https://runapi.ai/zh-HK/models/hailuo)
- [Model catalog](https://runapi.ai/zh-HK/models)
- [API docs](https://runapi.ai/zh-HK/docs)