mcpField
H
hailuo-video

hailuo-video

github.com/acedatacloud创意与媒体17227 次安装今天更新
代码仓库

关于 hailuo-video

hailuo-video 是用于通过 AceDataCloud 的 Hailuo（MiniMax）API 生成视频的 OpenClaw 技能，支持文本生成和图像动画，并提供更精细的导演模式控制。

主要功能

  1. 01文本生成视频
  2. 02图像动画生成视频
  3. 03导演模式精细控制动画
  4. 04异步任务轮询

适用场景

  1. 01根据文本描述制作片段
  2. 02将静态图像制作成视频
  3. 03控制图像动画中的镜头和运动

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/acedatacloud/skills --skill hailuo-video

安装后在 Claude Code 中输入/hailuo-video确认已加载。

详细介绍

海螺视频生成

通过 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 主机上，将 ACEDATACLOUD_API_TOKEN=your_api_key_here 放入 ~/.openclaw/.env，然后重启 Gateway 并启动新会话。若要直接在终端测试，请在该 Shell 中运行 export ACEDATACLOUD_API_TOKEN="your_api_key_here"。切勿将密钥放入提示词或提交 .env 文件。
  5. 运行下方的 Quick Start。如果此工作流返回任务 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适用于 i2vstring源图像 URL（图像转视频时必填）
callback_url否string异步回调 URL

注意事项

  • minimax-i2v 和 minimax-i2v-director 模型必须提供 first_image_url
  • Director 模式（minimax-i2v-director）比标准 i2v 提供更精细的镜头和动作控制
  • action 字段目前仅支持 "generate"，不支持扩展或编辑
  • 每次生成均采用统一定价，与模型无关

评论

支持 Markdown