本地 API

Curlo 提供了一个本地 HTTP API，允许您将其搜索和资产管理功能集成到您自己的工具和工作流程中——所有处理均在您的设备上本地完成。

启用 API

1. 通过 macOS 菜单栏或按快捷键 Cmd+, 打开 Settings (设置)。
2. 导航至 Advanced (高级) 选项卡。
3. 开启 Start Local Server (启动本地服务器)。
4. 默认情况下，API 将在 http://localhost:44100 访问。您可以根据需要修改此端口号。

身份验证与网络访问

默认情况下，本地 API 不需要身份验证。出于安全考虑，它严格绑定在您的本地机器（localhost）上，无法被网络上的其他设备访问。

将 API 暴露到局域网（LAN）：

如果您需要从网络上的其他设备访问 API（例如从平板电脑或副屏电脑控制 Curlo），您需要手动配置网络环境，例如设置反向代理或端口转发。

⚠️ 安全警告： 由于 API 没有内置的密码或 Token 身份验证，将其暴露到局域网意味着同一网络上的任何人都可以查询您的音频库。如果您选择这样做，我们强烈建议：

1. macOS 防火墙： 导航至 系统设置 > 网络 > 防火墙，配置规则以确保只有受信任的 IP 才能访问 API 端口（默认：44100）。
2. 反向代理： 使用反向代理服务器（如 Nginx 或 Caddy）来暴露服务并添加 HTTP 基本身份验证。

端点

方法	路径	描述
POST	/search	使用过滤器搜索音频库
GET	/asset	获取单个资产的完整详情