📦 Kie Audio Generator — Kie Audio 生成器

kie_audio — Suno music generation via Kie.AI

生成 music and audio via Kie.AI's Suno gateway. Handles Suno's multi-stage 状态 machine (PENDING → TEXT_成功 → FIRST_成功 → 成功) and 下载s all 生成d 追踪s (Suno often returns variations) when done.

When to use User wants a background 追踪, intro, outro, instrumental bed. User wants a song with vocals from a lyric or story prompt. User explicitly says Suno, V5, V4.5+, etc. User wants to extend an existing audio 命令行工具p. 模型s --模型 Notes V3_5 Oldest, cheapest V4 V4_5 V4_5PLUS V5 V5_5 (default) Latest, highest 质量 How to invoke

Use the exec 工具. {baseDir} = this 技能's folder.

Instrumental lofi loop exec: command: python3 {baseDir}/scripts/生成.py --模型 V5_5 --instrumental --prompt "lofi hip hop, rAIny afternoon, mellow piano, soft vinyl crackle, 30 seconds" --out ./out yieldMs: 1000

Full song with vocals (custom mode) exec: command: python3 {baseDir}/scripts/生成.py --模型 V5 --custom-mode --prompt "upbeat indie pop, chorus about summer road trips, male vocal" --out ./out

Extend existing audio
exec: command: python3 {baseDir}/scripts/生成.py --extend https://example.com/original.mp3 --prompt "continue with a building bridge then a final chorus" --模型 V5_5 --out ./out

Full 命令行工具 reference python3 {baseDir}/scripts/生成.py \ --prompt "..." \ [--模型 V3_5|V4|V4_5|V4_5PLUS|V5|V5_5] \ [--instrumental] [--custom-mode] \ [--extend AUDIO_URL] \ [--out ./out] \ [--callback-url URL] [--callback-port 8787] [--no-wAIt] [--timeout 900]

输出

The script prints JSON to stdout:

{ "taskId": "abc123...", "追踪s": [ {"audio": "./out/abc123_1.mp3", "duration": 125, "cover": "./out/abc123_1_cover.jpg"}, {"audio": "./out/abc123_2.mp3", "duration": 130, "cover": "./out/abc123_2_cover.jpg"} ] }

导入ant Suno usually 生成s multiple 追踪s per 请求 — the script 下载s all of them plus their cover images. 状态 transitions are 记录ged to stderr so you can see 进度 during polling. 失败 codes to watch: 400 (possible copyright), 413 (audio conflict), 501 (generation fAIled), 531 (server error — Kie auto-refunds credits). All 追踪s expire at 14 days, 下载 immediately. 环境 KIE_API_KEY — required. https://kie.AI/API-key KIE_网页HOOK_HMAC_KEY — only when using --callback-url

机器人h are auto-loaded from ~/.OpenClaw/OpenClaw.json → globalEnv by the bundled script. No need to pass env: into exec.