Add Seedance 2.0 video generation to your AI Agent.
Seedance 2.0 • Install • API Key • HiAPI
Get API Key · Pricing · HiAPI Docs · All HiAPI Skills · Remote MCP
HiAPI Matrix: 🎨 Image Prompts · 🎬 Video Prompts · 🛠️ Agent Skills (you are here) · 🤖 Remote MCP · 📖 API Docs
AI Agent? Skip the README and read llms-install.md. It contains installation steps and error-handling rules written for agents.
An AI video generation skill for OpenClaw / Claude Code / OpenCode / Codex-style agents. After installation, your AI Agent can use Seedance 2.0 through HiAPI to generate videos from text or animate an image.
HiAPI is an AI API platform built for developers: one API, all AI models. Images, video, music, and text with one key.
| Skill | Description | Model |
|---|---|---|
| HiAPI Seedance 2.0 Video | Text-to-video and image-to-video | Seedance 2.0 |
Use this skill when the user needs a stronger video workflow, especially text-to-video plus image-to-video. If the user needs a fast lightweight text-to-video draft, route them to hiapi-happyhorse-1-0-video-skill. If their brief is one or two sentences and they need a directed, scene-by-scene prompt before generating, run it through hiapi-video-prompt-generator-skill first. If they need a still-image starting point before animation, use awesome-gpt-image-2-prompts. For broader agent discovery, use hiapi-skills or Remote MCP at https://mcp.hiapi.ai/mcp.
npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -yThe installer auto-detects Codex (~/.codex/skills) and Claude Code (~/.claude/skills). If both exist, the -y flag installs to both. To target a specific agent or directory:
npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --codex # ~/.codex/skills only
npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --claude # ~/.claude/skills only
npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --target=/path # custom directory
AGENT_SKILLS_DIR=/path npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -yThe script also reports whether HIAPI_API_KEY is set and links to where to create one.
openclaw skills add https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skillgit clone https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill.git
export AGENT_SKILLS_DIR="/path/to/your/agent/skills"
mkdir -p "$AGENT_SKILLS_DIR"
cp -R hiapi-seedance-2-0-video-skill "$AGENT_SKILLS_DIR/hiapi-seedance-2-0-video"Replace AGENT_SKILLS_DIR with your agent's skill directory.
Install the HiAPI Seedance 2.0 video generation skill:
1. Run: npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y
(auto-detects Codex / Claude Code skill directories)
2. Set the HIAPI_API_KEY environment variable from https://www.hiapi.ai/en/dashboard/api-keys
3. Read SKILL.md for usage
- Open Get API Key
- Sign in or create a HiAPI account
- Create a new API Key
- Set the environment variable in the terminal that runs your agent:
export HIAPI_API_KEY="your_hiapi_api_key_here"
export HIAPI_BASE_URL="https://api.hiapi.ai"Check configuration:
node scripts/check-config.mjsPublic network check:
node scripts/check-config.mjs --live--live only checks that the public pricing endpoint is reachable. It does not authenticate or validate the API key.
Ask your AI Agent to generate a video with natural language. If you provide an image, Seedance 2.0 can use it as the starting frame and turn it into motion.
- Text-to-video: describe a scene, camera movement, mood, and sound atmosphere
- Image-to-video: provide a public image URL or data URI and describe how it should move
- Durations: any integer from
4to15seconds - Resolutions:
480p,720p,1080p,4k(premium-priced) - Ratios:
16:9,9:16,1:1,4:3,3:4,21:9,adaptive - Media modes: text-to-video, first-frame image-to-video, first+last-frame image-to-video, or multimodal references
- Generated audio is on by default (API default); pass
--no-audioto disable,--generate-audioto force on - Reproducible output: pass
--seed <0-2147483647> - Local output: videos are saved to
outputs/when the result can be downloaded - URL output: if the video cannot be downloaded, the Agent returns the remote video URL
- Clear errors: missing Key, invalid Key, insufficient balance, invalid image URL, task timeout, and task failure all include a next step
- Long-running jobs: polling defaults to 120 minutes and can be shortened with
--timeout-minutes <1-120>
Talk directly to your AI Agent:
Use
$hiapi-seedance-2-0-videoto generate a 5-second cinematic ocean cliff video.
Use HiAPI Seedance 2.0 to create a vertical product teaser video, 9:16 style.
Animate this product photo with soft camera movement and studio lighting.
Text-to-video:
node scripts/hiapi-seedance-2-video.mjs \
--prompt "A cinematic shot of ocean waves crashing against cliffs at golden hour" \
--seconds 5 \
--resolution 720p \
--ratio 16:9 \
--timeout-minutes 120Image-to-video:
node scripts/hiapi-seedance-2-video.mjs \
--prompt "The product photo comes alive with soft camera movement and studio lighting" \
--first-frame-url "https://example.com/product.jpg" \
--seconds 5First+last-frame image-to-video:
node scripts/hiapi-seedance-2-video.mjs \
--prompt "Animate from the first frame to the final hero frame" \
--first-frame-url "asset://first-frame" \
--last-frame-url "asset://last-frame" \
--seconds 5With generated audio:
node scripts/hiapi-seedance-2-video.mjs \
--prompt "A coffee shop scene with natural background ambience" \
--seconds 5 \
--generate-audioMultimodal reference mode:
node scripts/hiapi-seedance-2-video.mjs \
--prompt "Use the reference images, video motion, and audio mood to create a product spot" \
--reference-image-url "asset://image-1" \
--reference-video-url "asset://video-1" \
--reference-video-duration 6 \
--reference-audio-url "asset://audio-1" \
--reference-audio-duration 5 \
--seconds 5Media modes are mutually exclusive: first-frame image-to-video, first+last-frame image-to-video, and multimodal reference mode cannot be mixed in one request. If you need strict first and last frames, use first+last-frame mode. If you need references plus a start/end idea, describe which reference should act as the first or last frame in the prompt.
Reference material limits:
reference_image_urlsplus first/last-frame images: at most 9 images total.reference_video_urls: at most 3 videos; each 2-15 seconds; total duration at most 15 seconds.reference_audio_urls: at most 3 audio clips; each 2-15 seconds; total duration at most 15 seconds.
.
├── README.md
├── README.zh-CN.md
├── SKILL.md
├── agents/
│ └── openai.yaml
├── references/
│ ├── api.md
│ └── output.md
├── scripts/
│ ├── check-config.mjs
│ ├── hiapi-seedance-2-video.mjs
│ └── lib/
│ └── seedance-2-video.mjs
├── tests/
│ └── seedance-2-video.test.mjs
└── llms-install.md
| Problem | Solution |
|---|---|
HIAPI_API_KEY is required |
Create a Key at Get API Key, then set HIAPI_API_KEY. |
401 Unauthorized |
Check whether the API Key is correct, or generate a new Key. |
402 Payment Required / 403 quota / insufficient balance |
Open the HiAPI Dashboard and check your account status. |
400 Bad Request |
Check duration, resolution, ratio, media mode, reference counts, and reference audio/video durations. |
429 Too Many Requests |
Wait and retry, or reduce concurrent generation requests. |
| Task timed out | The video may still be running. The default polling limit is 120 minutes; use --timeout-minutes <1-120> to set a shorter limit. |
| Task failed | Try a clearer prompt or a different image. |
| No video output | Check the task response; this skill expects a video URL after the task succeeds. |
| Skill update available | The CLI checks the HiAPI skills index at startup. If the update is optional, it prints the upgrade command and continues. |
| Skill update required | The CLI stops and prints the required upgrade command. Run npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y, then restart your agent. |
Set HIAPI_SKIP_UPDATE_CHECK=1 only for offline or locked-down environments where the skills index cannot be reached.
| Agent | Install Method |
|---|---|
| Codex | npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --codex |
| Claude Code | npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --claude |
| OpenClaw | openclaw skills add https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill |
| OpenCode | AGENT_SKILLS_DIR=~/.opencode/skills npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y |
| Cursor / other | npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --target=/your/skills/dir |
MIT
HiAPI — One API, all AI models