Skills

HiAPI Skills are local add-ons for agent runtimes. Each Skill focuses on one model or one stable workflow, so an agent can complete a repeated task with a short instruction.

Use Remote MCP when you want to connect HiAPI tools in chat.
Use Skills when you want a local one-click capability for a specific model, such as GPT Image 2, Seedance 2.0, or HappyHorse 1.0.

Available Skills

Skill	Model	Best for	Repository
GPT Image 2 Skill	`gpt-image-2`	Posters, illustrations, cover images, social graphics, and other text-to-image assets	GitHub
Seedance 2.0 Video Skill	`seedance-2-0`	Text-to-video, image-to-video, cinematic clips, product videos, and storyboards	GitHub
HappyHorse 1.0 Video Skill	`happyhorse-1-0`	Short videos, ad storyboards, and social media video assets from text prompts	GitHub

After installation, the agent can call the selected model directly and save the generated result through the Skill scripts.

Install

Get a HiAPI API key

Go to HiAPI Dashboard -> API Keys and create or copy an API key.

Choose and install a Skill

OpenClaw can install the target repository directly:

# 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

For Codex, clone the selected repository into the local skills directory:

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"

Run npm test inside the installed skill repository when you want to verify the package.

Set your API key

Set the environment variables in the terminal that runs your agent:
Terminal window
```
export HIAPI_API_KEY="YOUR_HIAPI_API_KEY"
export HIAPI_BASE_URL="https://api.hiapi.ai"
```
Restart the agent

Restart Codex, Claude Code, OpenCode, OpenClaw, or the agent runtime you installed the Skill into.

Ask the agent to generate

Use $hiapi-gpt-image-2 to generate a 16:9 image of a sunset over the sea.

Use $hiapi-seedance-2-0-video to animate this product photo into a 5-second cinematic clip.

Use $hiapi-happyhorse-1-0-video to generate a 5-second 1080p wuxia rooftop scene.

Let an Agent Install It

If you want an agent to install a Skill for you, give it the matching agent notes:

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

The agent should clone the selected repository into its skills directory, set HIAPI_API_KEY, restart if needed, and read SKILL.md before generation.

Troubleshooting

Problem	What to do
`HIAPI_API_KEY is required`	Create an API key, then set the `HIAPI_API_KEY` environment variable as shown above
`401` or `403`	Check whether the API key is valid
`402`, balance, credits, or quota error	Add credits or check billing in the HiAPI dashboard
`429`	Wait and retry, or reduce concurrent generations
No output file	Ask the agent to run it again and check the terminal error message or returned result