跳转到内容
HiAPI Docs
HiAPI
中文
English 中文

Skills

HiAPI Skills 是安装在 Agent 本地的能力包。每个 Skill 聚焦一个模型或一个稳定工作流，让 Agent 可以用更短的指令完成固定任务。

  • 如果你想在对话里连接 HiAPI 的多种工具，使用 远程 MCP。
  • 如果你想把某个模型做成本地一键能力，例如 GPT Image 2、Seedance 2.0 或 HappyHorse 1.0，使用 Skills。

当前可用 Skills

Section titled “当前可用 Skills”
Skill模型适合场景项目地址
GPT Image 2 Skillgpt-image-2海报、插画、封面图、社交媒体配图等文生图任务GitHub
Seedance 2.0 Video Skillseedance-2-0文生视频、图生视频、电影感片段、产品视频和分镜GitHub
HappyHorse 1.0 Video Skillhappyhorse-1-0短视频、广告分镜、社媒视频素材等文生视频任务GitHub

安装后，你可以直接让 Agent 固定调用对应模型，并按 Skill 内置脚本保存生成结果。

安装

Section titled “安装”

  1. 获取 HiAPI API Key

    前往 HiAPI 控制台 -> API Keys 创建或复制一个 API Key。

  2. 选择并安装 Skill

    OpenClaw 可以直接安装对应仓库：

    Terminal window
    # GPT Image 2
    openclaw skills add https://github.com/HiAPIAI/hiapi-gpt-image-2-skill
    

    # Seedance 2.0 Video
    openclaw skills add https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill
    

    # HappyHorse 1.0 Video
    openclaw skills add https://github.com/HiAPIAI/hiapi-happyhorse-1-0-video-skill

    Codex 可以把选中的仓库克隆到本地 skills 目录：

    Terminal window
    mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
    

    # GPT Image 2
    rm -rf "${CODEX_HOME:-$HOME/.codex}/skills/hiapi-gpt-image-2"
    git clone https://github.com/HiAPIAI/hiapi-gpt-image-2-skill.git "${CODEX_HOME:-$HOME/.codex}/skills/hiapi-gpt-image-2"
    

    # Seedance 2.0 Video
    rm -rf "${CODEX_HOME:-$HOME/.codex}/skills/hiapi-seedance-2-0-video"
    git clone https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill.git "${CODEX_HOME:-$HOME/.codex}/skills/hiapi-seedance-2-0-video"
    

    # HappyHorse 1.0 Video
    rm -rf "${CODEX_HOME:-$HOME/.codex}/skills/hiapi-happyhorse-1-0-video"
    git clone https://github.com/HiAPIAI/hiapi-happyhorse-1-0-video-skill.git "${CODEX_HOME:-$HOME/.codex}/skills/hiapi-happyhorse-1-0-video"

    如果需要确认安装包本身没问题，可以进入对应 skill 仓库运行 npm test。

  3. 设置 API Key

    在运行 Agent 的终端设置环境变量：

    Terminal window
    export HIAPI_API_KEY="你的 HiAPI API Key"
    export HIAPI_BASE_URL="https://api.hiapi.ai"

  4. 重启 Agent

    重启 Codex、Claude Code、OpenCode、OpenClaw 或你安装 Skill 的 Agent 运行环境。

  5. 让 Agent 生成内容

    使用 $hiapi-gpt-image-2 生成一张 16:9 的海面日落图片。
    使用 $hiapi-seedance-2-0-video 把这张产品图做成 5 秒电影感视频。
    使用 $hiapi-happyhorse-1-0-video 生成一段 5 秒 1080p 的武侠屋顶飞跃视频。

让 Agent 自动安装

Section titled “让 Agent 自动安装”

如果你想让 Agent 帮你安装，可以把对应 Skill 的 Agent 安装说明发给它：

https://github.com/HiAPIAI/hiapi-gpt-image-2-skill/blob/main/llms-install.md
https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill/blob/main/llms-install.md
https://github.com/HiAPIAI/hiapi-happyhorse-1-0-video-skill/blob/main/llms-install.md

Agent 应该把对应仓库克隆到自己的 skills 目录，设置 HIAPI_API_KEY，必要时重启，并在生成前读取 SKILL.md。

常见问题

Section titled “常见问题”
问题处理方式
HIAPI_API_KEY is required先创建 API Key，再按安装步骤设置 HIAPI_API_KEY 环境变量
401 或 403检查 API Key 是否有效
402、余额、积分或额度错误到 HiAPI 控制台充值或检查账单状态
429稍后重试，或降低并发生成数量
没有输出文件让 Agent 重新执行一次，并查看终端里的错误提示或返回结果