开启 HTTP API：TCP 协议、端口与接口令牌配置

它对外提供 RESTful API，下载、暂停、删除、查询任务全部接口化——这是 Webhook、脚本、SDK、AI 接入共同的地基。开启只要三步。

第一步：通讯协议切到 TCP

打开「设置 → 高级 → 通讯协议」，从默认档位切换为 TCP，并指定 IP 与端口。官方文档示例用 9999 端口（与 Web 版默认端口一致，纯本机桌面场景下可用任意未占用端口）。

第二步：设置接口令牌

同一页面下方有「接口令牌」配置——纯本机调用可以不设，但只要 API 会暴露给局域网其他设备，就必须设令牌，调用时携带。安全边界见公网部署必开认证。

第三步：重启主程序

官方文档明确标注：以上设置需要重启后生效——改完不重启、接口连不上，多半是漏了这一步。

验证接口

重启后用本机地址加端口访问，能返回接口响应即开启成功。接口的完整定义在官方的 OpenAPI 文档页（站点 docs 区的 openapi 页面），所有任务的增删查改都有对应端点。

改端口的原则

不要使用已被占用的端口或系统保留端口，否则服务起不来或访问失败——这是官方文档特别提醒的一点。

相关阅读

• 用代码调用：JS 与 Python SDK。
• 接口之上的通知机制：Webhook 通知。