hailuo-video

Hailuo 動画生成

AceDataCloud の Hailuo（MiniMax）API を使用して、AI 動画を生成します。

初回セットアップ

1. clawhub install @acedatacloud/hailuo で公式 Skill をインストールします。ClawHub の公開者が @acedatacloud であることを確認してください。
2. AceDataCloud → Applications にサインインし、General application を開いて、Hailuo へのアクセス、残高、現在の料金を確認します。API キーをコピーするか、Manage Keys → Create を選択して専用のキーを作成します。Bearer を含めずにキーの値をコピーしてください。platform-... の管理トークンはサービス API キーではありません。
3. Allowed APIs の制限を有効にする場合は、/hailuo/videos と /hailuo/tasks を含めます。以下の高度なワークフローでは、追加のルートを呼び出す場合があります。
4. OpenClaw Gateway ホストで、~/.openclaw/.env に ACEDATACLOUD_API_TOKEN=your_api_key_here を設定し、Gateway を再起動して新しいセッションを開始します。ターミナルから直接テストする場合は、そのシェルで export ACEDATACLOUD_API_TOKEN="your_api_key_here" を実行します。キーをプロンプトに記載したり、.env ファイルをコミットしたりしないでください。
5. 以下の クイックスタート を実行します。このワークフローからタスク ID が返された場合は、完了するまで同じタスクを照会してください。進捗を確認するためだけに、同じ課金対象リクエストを再送信しないでください。

キーの設定、初回実行、トラブルシューティングの図解 · トークンの詳細

クイックスタート

curl -X POST https://api.acedata.cloud/hailuo/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "a dolphin jumping through ocean waves at golden hour", "model": "minimax-t2v"}'

非同期： 非同期タスクのポーリングを参照してください。POST /hailuo/tasks に {"id": "..."} を指定してポーリングします。

モデル

モデル	種類	最適な用途
minimax-t2v	テキストから動画	テキストの説明から動画を作成する
minimax-i2v	画像から動画	静止画をアニメーション化する
minimax-i2v-director	画像から動画（Director）	画像からのアニメーションを正確に制御する

ワークフロー

1. テキストから動画

POST /hailuo/videos
{
  "action": "generate",
  "prompt": "a time-lapse of flowers blooming in a meadow",
  "model": "minimax-t2v"
}

2. 画像から動画

静止画をアニメーション化して動画クリップを作成します。

POST /hailuo/videos
{
  "action": "generate",
  "prompt": "gentle wind blows through the scene",
  "model": "minimax-i2v",
  "first_image_url": "https://example.com/landscape.jpg"
}

3. 画像から動画（Director モード）

アニメーションをより正確に制御できます。

POST /hailuo/videos
{
  "action": "generate",
  "prompt": "camera slowly zooms in while leaves fall gently",
  "model": "minimax-i2v-director",
  "first_image_url": "https://example.com/scene.jpg"
}

パラメーター

パラメーター	必須	値	説明
action	はい	"generate"	アクションの種類
prompt	はい	string	動画の説明
model	はい	"minimax-t2v"、"minimax-i2v"、"minimax-i2v-director"	モデル
first_image_url	i2v の場合	string	元画像の URL（画像から動画を生成する場合は必須）
callback_url	いいえ	string	非同期コールバック URL

注意点

• minimax-i2v と minimax-i2v-director モデルでは、first_image_url が必須です。
• Director モード（minimax-i2v-director）では、標準の i2v よりもカメラや動きを細かく制御できます。
• 現在、action フィールドでサポートされているのは "generate" のみです。延長や編集には対応していません。
• モデルにかかわらず、生成ごとの料金は一律です。