audio-song-generate

사용 방법

설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.

npx skills add https://github.com/meitu/meitu-skills --skill audio-song-generate

시작 전 확인

설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.

원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Audio Song Generate

Overview

歌词驱动的完整歌曲生成（含人声，主歌/桥段/合唱完整结构），多风格创作（流行/古风/电子/摇滚等）。也支持强节奏 / 完整编曲感的纯音乐，编曲能力优于通用纯音乐工具。

API Mapping

歌曲与强节奏纯音乐生成：audio_cashew_songgenerate

Dependencies

meitu-cli: >=2.0.6
凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）
环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver

Preflight

meitu --version ≥ 2.0.6
已用 CONFIG AKSK 跑过 meitu tools update
当前 AKSK = EXEC，MEITU_OPENAPI_TOOL_TASK_MODE=command
output_dir：openclaw.yaml → ./output/ ｜else → $VISUAL/output/audio-song-generate/；mkdir -p

Execute

触发信号 / 路由规则

核心维度：人声/编曲场景命中 + 参数齐全。

场景	判定关键词	路由
含人声的完整歌曲	写首歌、带人声、带歌词、唱一首、品牌歌曲	`audio_cashew_songgenerate`
强节奏 / 完整编曲的纯音乐	强节奏、强变化、反转旋律、完整编曲感	`audio_cashew_songgenerate`

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。风格与歌词矛盾时以 prompt（风格）为准。

参数定义

参数	类型	必填	范围	默认	说明
`prompt`	STRING	是	--	--	歌曲风格描述。缺失 → 提示"请描述你想要的歌曲风格"
`prompt_lyrics`	STRING	是	--	--	歌词内容。缺失 → 提示"请提供歌词内容"（强节奏纯音乐场景可填空字符串或风格化描述）
`model`	STRING	否	auto / mureka-6 / mureka-7.5 / mureka-o1	auto	生成模型选择，非法值回退 auto

audio_cashew_songgenerate 使用 prompt + prompt_lyrics + model。人声质量受多语言发音影响。

工具调用

bash

meitu audio-song-generate --prompt "<style>" --prompt_lyrics "<lyrics>" [--model auto] --json --download-dir {output_dir} --skill_name skill_audio-song-generate

错误降级

场景	处理方式
`prompt` 缺失	提示"请描述你想要的歌曲风格"，不调用 API
`prompt_lyrics` 缺失（含人声场景）	提示"请提供歌词内容"，不调用 API
`model` 指定了不存在的值	回退 `auto`
`audio_cashew_songgenerate` 调用失败	重试 1 次，仍失败返回错误
`prompt` 与 `prompt_lyrics` 风格矛盾	以 `prompt` 为准，告知用户歌词将按指定风格编曲
用户只要歌词不要旋律	拒绝，不属于本工具范围
内容合规拦截	直接返回合规提示，不重试

Deliver

使用 Preflight 解析的 output_dir
从 downloaded_files[0].saved_path 读取已下载音频文件路径
mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_audio-song-generate.mp3