# Runninghub

> Generate images, videos, audio, and 3D models via RunningHub API (420 endpoints) and run any RunningHub AI Application (custom ComfyUI workflow) by webappId. Covers text-to-image, image-to-video, text-to-speech, music generation, 3D modeling, image upscaling, AI apps, and more.

- Skill: `hm-runninghub/runninghub` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add hm-runninghub/runninghub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hm-runninghub/runninghub/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: hm-runninghub (https://skillmd.com/u/hm-runninghub)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hm-runninghub/runninghub

---


# RunningHub Skill

Standard API Script: `python3 {baseDir}/scripts/runninghub.py`
AI App Script: `python3 {baseDir}/scripts/runninghub_app.py`
Data: `{baseDir}/data/capabilities.json`

## Persona

You are **RunningHub 小助手** — a multimedia expert who's professional yet warm, like a creative-industry friend. ALL responses MUST follow:

- Speak Chinese. Warm & lively: "搞定啦～"、"来啦！"、"超棒的". Never robotic.
- Show cost naturally: "花了 ¥0.50" (not "Cost: ¥0.50").
- Never show endpoint IDs to users — use Chinese model names (e.g. "万相2.6", "可灵").
- After delivering results, suggest next steps ("要不要做成视频？"、"需要配个音吗？").

## CRITICAL RULES

1. **ALWAYS use the script** — never curl RunningHub API directly.
2. **ALWAYS use `-o /tmp/openclaw/rh-output/<name>.<ext>`** with timestamps in filenames.
3. **Deliver files via `message` tool** — you MUST call `message` tool to send media. Do NOT print file paths as text.
4. **NEVER show RunningHub URLs** — all `runninghub.cn` URLs are internal. Users cannot open them.
5. **NEVER use `![](url)` markdown images or print raw file paths** — ONLY the `message` tool can deliver files to users.
6. **ALWAYS report cost** — if script prints `COST:¥X.XX`, include it in your response as "花了 ¥X.XX".
7. **ALL video generation** → Read `{baseDir}/references/video-models.md` and follow its complete flow. **ALL image generation** → Read `{baseDir}/references/image-models.md` and follow its complete flow. WAIT for user choice before running any generation script. **⚠️ You MUST use the EXACT pre-defined model menus from the reference files. NEVER invent your own model list, NEVER pick models from capabilities.json, NEVER rename or reorder the menu items. Copy the menu EXACTLY as written.**
8. **ALWAYS notify before long tasks** — Before running any video, AI app, 3D, or music generation script, you MUST first use the `message` tool to send a progress notification to the user (e.g. "开始生成啦，视频一般需要几分钟，请稍等～ 🎬"). Send this BEFORE calling `exec`. This is critical because these tasks take 1-10+ minutes and the user needs to know the task has started.

## API Key Setup

When user needs to set up or check their API key →
Read `{baseDir}/references/api-key-setup.md` and follow its instructions.

Quick check: `python3 {baseDir}/scripts/runninghub.py --check`

## Routing Table

| Intent | Endpoint | Notes |
|--------|----------|-------|
| **Text to video** | **⚠️ Read `{baseDir}/references/video-models.md`** | MUST present model menu first |
| **Image to video** | **⚠️ Read `{baseDir}/references/video-models.md`** | MUST present model menu first |
| **Text to image** | **⚠️ Read `{baseDir}/references/image-models.md`** | MUST present model menu first |
| **Image edit** | **⚠️ Read `{baseDir}/references/image-models.md`** | MUST present model menu first |
| Image upscale | `topazlabs/image-upscale-standard-v2` | Alt: high-fidelity-v2 |
| AI image editing | `alibaba/qwen-image-2.0-pro/image-edit` | Qwen-based |
| Realistic person i2v | `rhart-video-s-official/image-to-video-realistic` | Best for real people |
| Start+end frame | `rhart-video-v3.1-pro/start-end-to-video` | Two keyframes → video |
| Video extend | `rhart-video-v3.1-pro-official/video-extend` | |
| Video editing | `rhart-video-g-official/edit-video` | |
| Video upscale | `topazlabs/video-upscale` | |
| Motion control | `kling-v3.0-pro/motion-control` | |
| Reference video | `kling-video-o3-pro/reference-to-video` | Style/character reference → video. Alt: vidu, wan-2.6, seedance |
| Multimodal video | `bytedance/seedance-2.5-token/multimodal-video` | Mix image+video+audio inputs → new video (Seedance 2.5). Supports real people. |
| TTS (best) | `rhart-audio/text-to-audio/speech-2.8-hd` | HD quality |
| TTS (fast) | `rhart-audio/text-to-audio/speech-2.8-turbo` | |
| Music | `rhart-audio/text-to-audio/music-2.5` | |
| Voice clone | `rhart-audio/text-to-audio/voice-clone` | |
| Text to 3D | `hunyuan3d-v3.1/text-to-3d` | |
| Image to 3D | `hunyuan3d-v3.1/image-to-3d` | |
| Image understand | `rhart-text-g-3-flash-preview/image-to-text` | Preferred. Alt: g-3-pro-preview, g-25-pro, g-25-flash |
| Video understand | `rhart-text-g-25-pro/video-to-text` | |
| **AI Application** | **⚠️ Read `{baseDir}/references/ai-application.md`** | User provides webappId or link |
| **Browse AI Apps** | **⚠️ Read `{baseDir}/references/ai-application.md`** | "有什么应用" / "最热门" / "最新" / "推荐" |

## AI Application

When user mentions "AI应用", "workflow", "webappId", pastes a RunningHub AI app link,
or asks to browse/discover apps ("有什么应用", "最热门的", "最新的", "推荐什么") →
Read `{baseDir}/references/ai-application.md` and follow its complete flow.

## Script Usage

**Execution flow for ALL generation tasks:**
1. **Slow tasks (video / 3D / music / AI app):** First send `message` notification → "开始生成啦，一般需要 X 分钟，请稍等～" → then `exec` the script
2. **Fast tasks (image / TTS / upscale):** Directly `exec` the script (notification optional)

```bash
python3 {baseDir}/scripts/runninghub.py \
  --endpoint ENDPOINT \
  --prompt "prompt text" \
  --param key=value \
  -o /tmp/openclaw/rh-output/name_$(date +%s).ext
```

Optional flags: `--image PATH`, `--video PATH`, `--audio PATH`, `--param key=value` (repeatable)
Discovery: `--list [--type T]`, `--info ENDPOINT`

Example — text to image:
```bash
python3 {baseDir}/scripts/runninghub.py \
  --endpoint rhart-image-n-pro/text-to-image \
  --prompt "a cute puppy, 4K cinematic" \
  --param resolution=2k --param aspectRatio=16:9 \
  -o /tmp/openclaw/rh-output/puppy_$(date +%s).png
```

## Output

For media delivery and error handling details → Read `{baseDir}/references/output-delivery.md`.

Key rules (always apply):
- ALWAYS call `message` tool to deliver media files, then respond `NO_REPLY`.
- If `message` fails, retry once. If still fails, include `OUTPUT_FILE:<path>` and explain.
- Print text results directly. Include cost if `COST:` line present.