跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Skills

安装 HiAPI Skills 后，可在 Claude Code、Codex 或 OpenClaw 中提交图像和视频生成请求。生成技能会根据模型文档处理参数、发起生成并返回结果；纯提示词技能只负责编写或审核提示词，不会创建 API 任务。

生成技能使用统一异步接口，需要设置 HIAPI_API_KEY。纯提示词技能不创建 API 任务，不需要 API Key。

技能一览

Section titled “技能一览”

每张卡片均提供安装命令。复制命令并在终端执行即可完成安装。

图片生成

Section titled “图片生成”

GPT Image 2

支持文生图，也支持使用参考图进行编辑和融合。提供标准版、Pro 版及对应的图生图版本，适用于海报、插画、产品图和封面等场景。

模型参数 · GitHub

npx -y github:HiAPIAI/hiapi-gpt-image-2-skill -y

Seedream 5.0 Pro

支持图内文字、毛笔书法、写实细节和多参考图合成的图像生成与编辑。使用 quality=basic 进行 1K 迭代，使用 quality=high 进行 2K 输出。

模型参数 · GitHub

npx -y github:HiAPIAI/hiapi-seedream-5-0-pro-skill -y

视频生成

Section titled “视频生成”

Seedance 2.5

支持文生视频、图生视频和参考生视频，最长 30 秒并支持原生音频。包含付费前预检与估价、幂等提交、任务恢复、下载以及技术和内容质检。

模型参数 · GitHub

Seedance 2.0

旗舰视频生成，支持文生视频、图片首尾帧控制、图片/视频/音频参考和同步音频，适用于电影感视频制作。

模型参数 · GitHub

HappyHorse 1.0

快速文生视频，支持 3–15 秒、最高 1080p 的视频生成，适用于短视频生成、创意验证和成本敏感型任务。

模型参数 · GitHub

提示词生成

Section titled “提示词生成”

Video Prompt Generator

将简要创意、链接或主题扩展为完整的视频提示词，补充镜头、运镜、画面文字和节奏信息，供上方视频技能使用。

GitHub
npx -y github:HiAPIAI/hiapi-video-prompt-generator-skill -y

查找更多技能

Section titled “查找更多技能”
查看 HiAPI 技能集合

安装

Section titled “安装”

  1. 配置 API Key

    在 控制台 → API Keys 创建，然后导出到环境变量（需要 Node.js 18+）：

    Terminal window
    export HIAPI_API_KEY="your_hiapi_api_key_here"

  2. 安装技能

    以下命令会安装页面列出的 6 个技能；每个安装器会自动识别 Claude Code / Codex 并选择对应目录：

    Terminal window
    npx -y github:HiAPIAI/hiapi-gpt-image-2-skill -y
    npx -y github:HiAPIAI/hiapi-seedream-5-0-pro-skill -y
    npx -y github:HiAPIAI/hiapi-seedance-2-5-video-skill -y
    npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y
    npx -y github:HiAPIAI/hiapi-happyhorse-1-0-video-skill -y
    npx -y github:HiAPIAI/hiapi-video-prompt-generator-skill -y

  3. 开始使用技能

    安装完成后即可向 Agent 提交请求，例如：

    「用 GPT Image 2 生成一张极简风格的产品海报」

    「先帮我把这个想法整理成视频提示词，再用 Seedance 生成」

    「用 HappyHorse 做一条 3 秒的测试视频」

在支持的情况下，生成结果会下载到本地 outputs/ 目录。远程 CDN 链接约 7 天后过期，需要长期保存的文件请及时下载。

更新机制

Section titled “更新机制”

技能每次运行前会对照官方目录 skills.json 检查版本。有新版本时显示升级提示；遇到不兼容的接口变更时，需要重新执行安装命令。离线时自动跳过检查，不影响生成。

不需要这个检查时，设置 HIAPI_SKIP_UPDATE_CHECK=1 即可关闭。

排障

Section titled “排障”
现象处理
HIAPI_API_KEY is required导出 API Key——在 控制台 → API Keys 创建
HTTP 401 / 403确认 API Key 正确且有效
HTTP 402、余额不足到 控制台 → 充值 充值；参考 定价
HTTP 400 参数错误对照模型页检查参数组合
HTTP 429稍等重试，或降低并发
提示”必须更新”重新执行安装命令后重试
等待超时任务可能仍在生成——稍后在控制台或通过 GET /v1/tasks/:id 查看结果

需要通过单一入口接入多个模型时，请使用 Remote MCP。需要集成到产品时，请直接调用统一异步接口。