其他

无视频时用文字描述生成单条音效：用 Sonilo…

当用户只用文字描述想要的声音、没有视频素材可匹配时，用 Sonilo text-to-sfx 生成一条音效片段。

被复用0 次

复用有效—

置信度55%

沉淀时间2026-09-23

🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）

来自 dongella 的小呱沉淀

GDI C 35/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35

使用度 0/100 ×0.30

口碑 50/100 ×0.20

新鲜度 38/100 ×0.15

适用场景

无视频时用文字描述生成单条音效：用 So特定

解决思路

先按 setup-api-key 完成 Sonilo 设置：需要任一 transport（MCP server 已连接，或已安装并登录 `sonilo` CLI），以及凭据（`sonilo login` 登录、hosted OAuth plugin 或 `SONILO_API_KEY`）。
注意成本：该工具会发起可能产生费用的 API 调用；只在用户明确请求时调用。
选择 transport：如果本次会话中可见 Sonilo MCP 工具（如 `text_to_sfx` 等），优先使用它们；这是首选路径，不需要 shell，并且是唯一能在非常长的生成中存活的路径。若调用因认证失败（不是输入失败）而失败，说明该 transport 在此会话不可用，改用 CLI，不要重试。
如果没有可用的 Sonilo MCP 工具，但 `sonilo account` 退出码为 0，则使用 CLI 命令；探测登录状态用 `sonilo account`，不要用 `sonilo whoami`，因为 `whoami` 即使未登录也退出 0，无法区分状态。
如果 MCP 和 CLI 都不可用，停止并运行 setup-api-key skill；不要用 curl 直接调用 `api.sonilo.com` 绕过，因为两种 transport 都处理上传、轮询和重试，裸请求没有这些。
在一次会话开始时选定一种 transport（MCP 或 CLI）并保持一致；不要在同一个任务中混用两者，也不要声明选择了哪一种。
MCP 调用示例：`text_to_sfx(prompt="Thunder rumbling in the distance with light rain", duration=6)`。
Python 用法：先 `pip install sonilo`；代码为 `from sonilo import Sonilo`、`client = Sonilo()`（读取 `SONILO_API_KEY`）、`sfx = client.text_to_sfx.generate(prompt="Thunder rumbling in the distance with light rain", duration=6)`、`sfx.save("thunder.m4a")`。
JavaScript / TypeScript 用法：先 `npm install sonilo`；代码为 `import { SoniloClient } from "sonilo";`、`const client = new SoniloClient();`（读取 `SONILO_API_KEY`）、`const sfx = await client.textToSfx.generate({ prompt: "Thunder rumbling in the distance with light rain", duration: 6 });`。
CLI 用法：用 `npm install -g sonilo-cli` 或 `pip install sonilo-cli` 安装；执行 `sonilo text-to-sfx --prompt "Thunder rumbling in the distance with light rain" --duration 6`。底层始终异步，CLI 会提交并轮询；`--format` 接受 `wav|mp3|aac|flac`。
cURL 原始 REST API 用法（无 MCP host）：`curl -X POST "https://api.sonilo.com/v1/text-to-sfx" -H "Authorization: Bearer $SONILO_API_KEY" --data-urlencode "prompt=Thunder rumbling in the distance with light rain" --data-urlencode "duration=6"`；返回 `{"task_id": "..."}`（HTTP 202），再轮询 `GET /v1/tasks/{task_id}` 直到 `status` 为 succeeded/failed。MCP 工具会代为轮询并直接返回保存路径；只有超时才会看到 `task_id`。
使用工具 `text_to_sfx(prompt, duration?, audio_format?, output_directory?)` 从纯文本描述生成一条 SFX 片段。
设置 `prompt`：必填，1–2000 字符。
设置 `duration`：可选，0.5–180 秒，默认使用 Sonilo 自己的默认值；当用户未指定长度时省略，不要臆造；允许小数值，最短效果如 latch 或 click 可低于 1 秒。
设置 `audio_format`：默认 `aac`（`.m4a`），可选 `wav`、`mp3`、`aac`、`flac`。
设置 `output_directory`：默认 `SONILO_MCP_BASE_PATH`；可为绝对路径，或相对于 base path 的路径。
Prompt 是唯一输入，没有视频可映射；直接描述动作和材料，并组合元素，例如 "Heavy rain on a tin roof" 优于 "Rain"；风格化提示可用 "Cinematic braam, horror" 或 "8-bit retro jump sound"；沿用视频路径相同的材料词汇和声音包思维，参考 `references/sfx-prompting.md`。
生成一次并在 prompt 上迭代，不要靠 reroll；失败运行会自动退款，但自己的重试会产生新费用。
适用于没有视频上下文的单条片段：UI chime、whoosh、自己会分层的 foley element；如果用户有素材，改用 video-to-sfx。
这里的 `duration` 是必需的；不要猜——用户没说就问。
不要和音乐混淆；背景配乐或原声使用 text-to-music 或 video-to-music。
超时恢复：后端已异步；长生成仍可能超过 `TIME_OUT_SECONDS`。如果超时，错误会带 `task_id`；任务继续运行（且已计费）。之后调用 `get_sfx_task(task_id)`——托管服务器上是 `get_generation_task(task_id)`——取回结果；参考 task-recovery。
输出文件：按请求的 `audio_format` 保存（`.wav`/`.mp3`/`.flac`，`aac` 默认则为 `.m4a`），文件名来自 prompt（slugified）或 `sfx-<first 8 chars of the task id>`。
错误处理：常见错误包括 `401` 无效密钥、`402` 余额不足/试用耗尽、`422` 无效参数（如 duration 超出范围）、`429` 速率限制；参考 account skill。

适用边界 · 注意事项

用户有视频素材、需要音效匹配画面节奏或钉到特定时刻时，改用 video-to-sfx。
用户要的是背景音乐、配乐或原声，而不是单条音效时，改用 text-to-music 或 video-to-music。
没有可用的 Sonilo MCP 工具或已登录 CLI，或缺少凭据时，不要直接 curl 调 `api.sonilo.com`，先运行 setup-api-key skill。