核心用法
本技能通过PoYo平台集成ElevenLabs Music API，提供两种音乐生成路径：一是文本描述模式（text），适合自然语言描述音乐风格、情绪与场景；二是结构化作曲计划模式（composition_plan），支持精确控制段落时长、乐器编排与音乐结构。用户需配置POYO_API_KEY环境变量，通过shell脚本或curl命令提交异步任务，获取task_id后可通过回调或轮询获取生成结果。
技能包含完整的API文档参考（references/api.md）和即用型提交脚本（scripts/submit_elevenlabs_music.sh），支持多种音频输出格式，可选配callback_url实现生产级队列管理。适用于需要程序化音乐生成的自动化工作流、内容创作管线及交互式应用场景。
显著优点
双模式灵活输入：文本描述门槛低，适合快速原型；作曲计划模式满足专业音乐人对结构的精细控制需求。纯Shell实现零依赖：除系统curl外无第三方库，部署轻量，兼容性强。安全设计到位：API密钥强制环境变量注入，脚本启用set -euo pipefail严格错误处理，HTTPS传输全程加密。异步架构适配生产：支持回调机制与任务状态查询，可融入复杂工作流而不阻塞主进程。文档完备：从模型页面、API文档到执行脚本形成完整使用闭环。
潜在缺点与局限性
外部服务强依赖：功能完全绑定PoYo平台可用性，服务变更或中断将直接影响技能运作。T3来源持续性风险：维护者为个人开发者（coolhackboy），长期更新与支持存在不确定性。无内置重试机制：网络波动或API限流时需外部实现容错逻辑。输入验证较基础：JSON载荷的schema校验依赖用户自行保障，错误提示友好度有限。音频质量不可控：AI生成音乐的审美一致性与特定风格还原度受模型能力边界制约。
适合的目标群体
- 内容创作者：需要为视频、播客、游戏快速生成配乐背景音
- 开发者与工程师：构建音乐生成自动化管线、集成AI能力至现有产品
- 产品经理/运营：原型验证阶段低成本探索AI音乐场景应用
- 独立游戏开发者：为独立项目批量生产程序化音乐素材
- 教育研究者：探索AIGC音乐生成的技术实现与教学演示
使用风险
密钥泄露风险：尽管实现层面安全，但用户误操作将密钥硬编码或提交至版本控制仍可能导致凭证暴露。数据隐私考量：生成请求内容（含文本描述）上传至PoYo第三方服务器，敏感场景需评估数据出境与存储政策。成本不可见：未内置用量监控，高频调用可能产生意外API费用。callback安全隐患：若配置外部回调URL，需防范SSRF类攻击与未授权端点暴露。生成结果版权：AI音乐版权归属需遵循ElevenLabs/PoYo平台最终用户协议，商业使用前应完成合规审查。