← 返回 Skills 市场
Hailuo Gyh
作者
skydream9527-ctrl
· GitHub ↗
· v1.0.1
· MIT-0
98
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install hailuo-gyh
功能描述
MiniMax 海螺视频生成技能。支持文生视频、图生视频、首尾帧视频、主体参考视频四种模式。使用前需设置环境变量 MINIMAX_API_KEY。
使用说明 (SKILL.md)
MiniMax 海螺视频生成
使用 MiniMax 海螺 API 生成视频。支持 4 种模式：
- 文生视频：根据文本描述生成视频
- 图生视频：基于图片 + 文本描述生成视频
- 首尾帧：首图 + 尾图 + 文本生成视频
- 主体参考：人脸照片 + 文本，保持人物特征一致
前置要求
- Python 3
pip3 install requests
使用方法
# 文生视频
python3 {baseDir}/scripts/video_gen.py --mode text --prompt "描述文字"
# 图生视频（推荐用于小说分镜）
python3 {baseDir}/scripts/video_gen.py --mode image --prompt "描述文字" --image "图片URL或本地路径"
# 首尾帧生成
python3 {baseDir}/scripts/video_gen.py --mode start_end --prompt "描述文字" --first "首图URL" --last "尾图URL"
# 主体参考
python3 {baseDir}/scripts/video_gen.py --mode subject --prompt "描述文字" --subject "人脸图片URL"
参数说明
| 参数 | 说明 | 必填 |
|---|---|---|
--mode |
模式：text/image/start_end/subject | 是 |
--prompt |
视频描述文本（建议英文，效果更佳） | 是 |
--image |
图生视频的首帧图片 URL（image 模式） | image 模式必填 |
--first |
首尾帧模式的首帧图片 URL | start_end 模式必填 |
--last |
首尾帧模式的尾帧图片 URL | start_end 模式必填 |
--subject |
主体参考模式的人脸图片 URL | subject 模式必填 |
--duration |
视频时长：6 或 10 秒，默认 6 | 否 |
--resolution |
分辨率：720P / 768P / 1080P，默认 768P | 否 |
--output |
输出文件名，默认 output.mp4 | 否 |
模型说明
- 文生视频 / 图生视频：
MiniMax-Hailuo-2.3（支持 768P / 1080P） - 首尾帧视频：
MiniMax-Hailuo-02（支持 768P / 1080P） - 主体参考：
S2V-01
⚠️ 注意：龚云荷的账户不支持 1080P，建议使用
--resolution 768P（已设为默认）。
示例（小说分镜）
python3 {baseDir}/scripts/video_gen.py \
--mode image \
--prompt "Cinematic winter scene in rural northern China. A young mother washes vegetables in icy well water. A little girl crouches nearby. Muted earth tones, film grain, shallow depth of field, melancholic atmosphere." \
--image "/Users/gyh/Desktop/obsidian_file/GYH_file/AI小说/情节反转小说/女性向/周桂兰.png" \
--duration 6 \
--resolution 768P \
--output "/Users/gyh/Desktop/obsidian_file/GYH_file/AI小说/情节反转小说/女性向/scene1.mp4"
API 配置
使用前需设置环境变量 MINIMAX_API_KEY（从 https://platform.minimax.com 获取）。
export MINIMAX_API_KEY="你的API Key"
安全使用建议
Do not provide long-lived or highly privileged API keys to this skill until you resolve the inconsistencies. Actions to consider before installing or running:
- Verify the API host: the script uses https://api.minimaxi.com but SKILL.md refers to platform.minimax.com. Confirm the correct official endpoint with the service provider to avoid typo-squatted domains.
- Confirm credential handling: _meta.json claims an embedded API key while the script requires MINIMAX_API_KEY; ask the author which is true. Avoid running code that claims to have an 'embedded' key unless you inspect it directly.
- If you test, use a limited-scope or disposable API key and run in an isolated environment (container/VM) to limit potential misuse.
- If you don't trust the author, inspect and, if necessary, modify the script to point to the known-good API endpoint or to log nothing sensitive. Prefer official SDKs or documented endpoints from the provider.
- Ask the publisher to correct registry metadata to list MINIMAX_API_KEY as a required env var and to resolve the conflicting _meta.json description; lack of accurate metadata is a red flag.
功能分析
Type: OpenClaw Skill
Name: hailuo-gyh
Version: 1.0.1
The skill is a legitimate wrapper for the MiniMax video generation API. The Python script (scripts/video_gen.py) implements standard API interactions, including task submission, status polling, and file downloading from the official endpoint (api.minimaxi.com). There is no evidence of data exfiltration, malicious execution, or prompt injection; the code correctly handles the API key via environment variables and uses safe libraries like requests and argparse.
能力评估
Purpose & Capability
The name, SKILL.md, and the included Python script all implement video-generation calls to a MiniMax-like API — requiring python3 and the requests library is consistent with that purpose. However registry metadata did not declare the MINIMAX_API_KEY requirement while both SKILL.md and the script do, which is an inconsistency.
Instruction Scope
SKILL.md instructs the agent/user to run the included Python script with expected arguments and to set MINIMAX_API_KEY. Examples reference local image file paths (expected for image-to-video use). The instructions do not ask for unrelated files or network exfiltration beyond calling the remote video API.
Install Mechanism
There is no install spec beyond running a Python script and installing requests via pip; no external download or archive extraction is performed by the skill itself. This is low-risk from an install/execution mechanism perspective.
Credentials
The package requires an API key (MINIMAX_API_KEY) in practice, but the registry metadata lists no required env vars and _meta.json claims an 'API Key 已内置' (API key included). The script actually reads MINIMAX_API_KEY from the environment and exits if not set. Additionally, SKILL.md tells users to obtain a key from platform.minimax.com while the script calls https://api.minimaxi.com (different hostname/typo). These contradictions are unexplained and could indicate sloppy packaging or an attempt to mislead users about credential handling.
Persistence & Privilege
The skill is not marked always:true and does not request persistent system-wide changes. It does not modify other skills or agent config. Autonomous invocation is allowed (platform default) and is not itself a new risk here.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install hailuo-gyh - 安装完成后，直接呼叫该 Skill 的名称或使用
/hailuo-gyh触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- 移除了脚本中内置的 API Key，改为需手动设置环境变量 MINIMAX_API_KEY。
- 更新了相关文档，API Key 配置说明更加清晰。
- 技能描述不再标注“龚云荷专属版”，适用范围更广。
v1.0.0
- Initial release of hailuo-gyh: MiniMax 海螺视频生成技能（龚云荷专属版）
- Supports four video generation modes: text-to-video, image-to-video, start-end frame video, and subject reference video
- No need to configure API Key; it is already built into the script
- Requires Python 3 and the requests package
- Includes detailed command-line usage instructions and parameter explanations
- Default resolution is 768P due to account limitations; 1080P is not supported for this user
元数据
常见问题
Hailuo Gyh 是什么？
MiniMax 海螺视频生成技能。支持文生视频、图生视频、首尾帧视频、主体参考视频四种模式。使用前需设置环境变量 MINIMAX_API_KEY。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 98 次。
如何安装 Hailuo Gyh？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install hailuo-gyh」即可一键安装，无需额外配置。
Hailuo Gyh 是免费的吗？
是的，Hailuo Gyh 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Hailuo Gyh 支持哪些平台？
Hailuo Gyh 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Hailuo Gyh？
由 skydream9527-ctrl（@skydream9527-ctrl）开发并维护，当前版本 v1.0.1。
推荐 Skills