JS 与 Python SDK：用代码控制下载任务

REST API 之上，官方维护了 JavaScript SDK，社区贡献了 Python 封装——不想手写 HTTP 请求的话，两条路都通。

JavaScript：官方库

安装：

npm install @gopeed/rest

创建客户端并建一个任务：

import { Client } from "@gopeed/rest";

(async function () {
  const client = new Client();
  const res = await client.createTask({
    req: {
      url: "magnet:?xt=urn:btih:你的资源指纹",
    },
  });
})();

SDK 里任务、配置、事件相关方法齐全；源码与更新说明在官方的 gopeed-js 仓库（GitHub 上）。

Python：社区库

社区用户 tick97115115 维护的封装：

pip install gospeed_api

用法与其示例代码见该项目在 GitHub 上的仓库说明（项目名 gospeed_api）。

直接裸调 HTTP

两个 SDK 不想用也行——接口是标准 RESTful，任何语言的 HTTP 库都能直接调，端点定义看官方 OpenAPI 文档页。前置条件只有一个：先按开启 HTTP API把 TCP 接口与令牌配好。

一个实用组合

SDK 建任务 + Webhook 通知收结果 = 完整闭环：上游程序提交下载，Webhook 把完成事件推回你的服务，继续后续流程。

相关阅读

• 不写代码的自动化：下载完成自动跑脚本。
• AI 代替你调 API：MCP 接入 AI 管理。