用途：仅凭文字描述生成音乐，不涉及视频配乐；适合需要器乐曲、背景垫乐、广告短曲或循环片段但没有视频可对齐的场景。若已有成片，应改用 video-to-music 以匹配剪辑节奏与情绪。
主要能力：提示词是唯一输入，需描述曲风、情绪、速度、配器与能量走向，并明确写清不应出现的声音。所有曲目经 Shutterstock 授权，可商用。支持时长 5–360 秒，默认从提示词推断；variants_num 可为 1–10，一次生成多个不同创意方向；output_format 支持 m4a 与 wav；stems=true 免费额外返回 drums、bass、vocals、other 四轨分轨，与完整混音并列返回。
使用方式：优先使用 Sonilo MCP 工具 text_to_music(prompt, duration?, output_format?, variants_num?, stems?, output_directory?)，结果保存到 SONILO_MCP_BASE_PATH（默认 ~/Desktop）。无 MCP 可用且 sonilo account 退出码为 0 时改用 CLI：sonilo text-to-music --prompt "..." --duration 30。也可用 Python（pip install sonilo）、JavaScript（npm install sonilo）或 REST：curl -X POST "https://api.sonilo.com/v1/text-to-music" -H "Authorization: Bearer $SONILO_API_KEY"。认证用 sonilo login 或 SONILO_API_KEY，需先完成 setup-api-key 技能。同一任务不要混用 MCP 与 CLI。
限制与费用：调用会产生费用，仅在用户明确要求生成时调用；可用 get_account_services 确认免费试用额度。variants_num 大于 1 时费用线性增长且不覆盖免费试用。stems 在 REST 上必须 mode=async，否则返回 400；分轨通常在生成后再花 2–6 分钟，超 30 分钟则写入 stems_error；分轨失败不代表生成失败，不要因此重试或退款。提示词不得引用具体艺人、乐队或受版权保护的歌词。常见错误有 401 密钥无效、402 余额不足或试用耗尽、422 参数无效、429 限流。异步变体超时时错误信息含 task_id，可调用 get_sfx_task(task_id)（托管服务器为 get_generation_task）取回结果。输出默认 .m4a，文件名由提示词 slug 化或 sonilo-<timestamp>.m4a。