粘贴分享链接
Ctrl + Enter 提交粘贴后自动识别网盘
网盘账号
每个网盘可添加多个账号,选中的那个用于转存。账号只属于你自己。
转存记录
| 时间 | 网盘 / 账号 | 名称 | 新分享链接 |
|---|
用户
| 用户名 | 邮箱 | 角色 | 网盘账号 | 注册时间 | 最近登录 | 状态 |
|---|
注册设置
开启后,新用户要填写邮箱并输入收到的验证码才能注册,以后也能用这个邮箱找回密码。
开放注册时,填了邀请码就只有知道邀请码的人能注册。
SMTP 发信设置
用于发送注册验证码、找回密码验证码和绑定邮箱验证码。配置好之后,登录页才会出现「忘记密码」。
测试使用上面表单里的内容(不需要先保存),密码留空时用已保存的密码。
常用邮箱参考
| 邮箱 | SMTP 服务器 | 端口 / 加密 | 说明 |
|---|---|---|---|
| QQ 邮箱 | smtp.qq.com | 465 / SSL | 密码填「授权码」:QQ 邮箱 → 设置 → 账号 → 开启 SMTP 服务后生成 |
| 腾讯企业邮 | smtp.exmail.qq.com | 465 / SSL | 建议使用客户端专用密码 |
| 163 邮箱 | smtp.163.com | 465 / SSL | 密码填「授权码」:设置 → POP3/SMTP/IMAP 里开启 |
| 阿里企业邮 | smtp.qiye.aliyun.com | 465 / SSL | 邮箱密码 |
| Gmail | smtp.gmail.com | 587 / STARTTLS | 需要开启两步验证并使用「应用专用密码」 |
云服务器通常封禁 25 端口,请使用 465 或 587。
API Key
加载中...
Key 属于当前登录的账号「」:用它调用接口时,使用的是你自己的网盘账号,记录也写进你自己的「转存记录」。服务器只保存 Key 的哈希,生成后只显示一次;忘了就重置,重置后旧 Key 立即失效。
接口文档
v1基本约定
- 接口地址:
/api/v1/... - 鉴权:请求头带
Authorization: Bearer pt_你的Key,或X-API-Key: pt_你的Key(二选一)。不需要登录 Cookie。 - POST 请求必须带
Content-Type: application/json,请求体是 JSON,最大 1 MB;否则返回 HTTP 415。 - 返回统一是 JSON:成功
{"ok": true, "data": ...},失败{"ok": false, "code": "错误码", "error": "中文说明"}。HTTP 状态码也会如实反映成功或失败,脚本里以ok和code判断即可,不要解析error文字。 - 同一个用户同一时间只能跑一个转存(网页和接口共用)。并发提交会立刻返回
409 busy,所以脚本请逐个串行调用,遇到 busy 等几秒重试。 - 转存是同步完成的:请求会一直等到「转存 + 生成新分享」结束才返回,一般几秒到一分钟,服务端最长等 10 分钟。客户端超时请设置为 660 秒以上;客户端中途断开会让服务端取消这次转存。
- 接口发起的转存会记入「转存记录」(
via为api),每个用户最多保留最近 500 条。
转存分享链接
POST/api/v1/transfer
把别人的分享转存到你的网盘,再用你的账号生成新分享。支持夸克、UC、百度、迅雷,按链接自动识别网盘。
请求参数(JSON)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 是 | 分享链接,也可以是整段分享文案(如「链接:https://pan.baidu.com/s/1xxx 提取码:abcd」),会自动提取链接和提取码。 |
passcode | string | 否 | 提取码。不填时依次从链接的 ?pwd= 和文案里的「提取码」识别。 |
dir | string | 否 | 转存到的目录,如 /转存/电影/2026,不存在会自动逐级创建。不填则用该网盘账号设置的目录。名字不能是 . / ..,不能含 <>:"|?*,最多 20 层。 |
account_id | string | 否 | 指定用哪个网盘账号(从 网盘账号接口 获取)。不填则用该网盘「转存用」的账号。账号必须和链接是同一个网盘。 |
请求示例
curl -sS -X POST "/api/v1/transfer" \
-H "Authorization: Bearer pt_你的Key" \
-H "Content-Type: application/json" \
--max-time 660 \
-d '{"url":"https://pan.quark.cn/s/abcd1234","passcode":"","dir":"/转存/电影"}'
成功返回(HTTP 200)
{
"ok": true,
"data": {
"id": "k3m9x2pq7a",
"provider": "quark",
"provider_name": "夸克",
"account": {"id": "a1b2c3d4e5", "name": "我的夸克"},
"source": {"url": "https://pan.quark.cn/s/abcd1234", "share_id": "abcd1234", "passcode": ""},
"title": "某某纪录片 全集",
"folder_name": "某某纪录片 全集",
"files": [
{"name": "某某纪录片 全集", "is_dir": true, "path": "/转存/电影/某某纪录片 全集"}
],
"file_count": 1,
"saved_to": "/转存/电影",
"saved_paths": ["/转存/电影/某某纪录片 全集"],
"share_url": "https://pan.quark.cn/s/9f8e7d6c5b4a",
"passcode": "",
"share_text": "某某纪录片 全集\n链接:https://pan.quark.cn/s/9f8e7d6c5b4a",
"created_at": "2026-11-21T10:30:00+08:00",
"elapsed_ms": 8421
},
"logs": [
"10:29:52 识别为夸克链接,使用账号「我的夸克」,目标目录 /转存/电影",
"10:30:00 完成: https://pan.quark.cn/s/9f8e7d6c5b4a"
]
}
失败返回(示例 HTTP 400)
{
"ok": false,
"code": "share_invalid",
"error": "夸克: 分享不存在",
"logs": ["10:29:52 识别为夸克链接,使用账号「我的夸克」,目标目录 /转存/电影", "10:29:52 读取分享 abcd1234", "10:29:53 失败: 夸克: 分享不存在"]
}
转存返回字段(data)
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 本次转存的记录 ID,和「转存记录」里的一致。 |
provider | string | 网盘标识:quark / uc / baidu / xunlei。 |
provider_name | string | 网盘中文名:夸克 / UC / 百度 / 迅雷。 |
account | object | 实际使用的网盘账号 {id, name}。 |
source | object | 原分享:url 你提交的原文,share_id 识别出的分享 ID,passcode 使用的提取码。 |
title | string | 分享标题。夸克/UC 取原分享标题,百度/迅雷取第一个文件名。 |
folder_name | string | 资源文件夹名:分享里只有一个顶层项目时就是它保存后的名字(通常就是资源文件夹),多个顶层项目时等于 title。适合直接拿来做二次处理的名称。 |
files | array | 分享的顶层项目,每项 {name, is_dir, path}:name 名称;is_dir 是否文件夹(百度不提供,此时没有该字段);path 保存在你网盘里的完整路径。 |
file_count | int | 转存的顶层项目数量。 |
saved_to | string | 保存到的目录(父目录)。 |
saved_paths | string[] | 每个顶层项目在你网盘里的完整路径,等于 files[].path。百度遇到同名时会自动改名(如加时间后缀),这里返回的是改名后的真实路径。 |
share_url | string | 新生成的分享链接(永久有效)。百度、迅雷的链接已带 ?pwd=。 |
passcode | string | 新分享的提取码;夸克/UC 通常为空。 |
share_text | string | 可直接发出去的分享文案(标题 + 链接 + 提取码)。 |
created_at | string | 完成时间,RFC 3339 格式。 |
elapsed_ms | int | 本次耗时(毫秒)。 |
外层的 logs 是处理过程日志(字符串数组),成功和失败都会返回,排查问题时有用。
查询网盘账号
GET/api/v1/accounts
返回你添加的全部网盘账号(不含 Cookie / token),用来拿 account_id 或检查账号状态。
curl -sS "/api/v1/accounts" -H "Authorization: Bearer pt_你的Key"
{
"ok": true,
"data": [
{"id": "a1b2c3d4e5", "provider": "quark", "provider_name": "夸克", "name": "我的夸克",
"dir": "/转存", "active": true, "status": "ok",
"added_at": "2026-11-01T09:00:00+08:00", "checked_at": "2026-11-20T12:00:00+08:00"}
]
}
active 为 true 表示该网盘默认用于转存的账号;status 为 ok 表示上次检查登录正常,空表示未检查,其他文字表示已失效的原因。
查询转存记录
GET/api/v1/history?q=关键词&limit=50
按时间从新到旧返回你的转存记录(网页和接口发起的都有)。可以用来去重:转存前先用原链接查一下是否转过。
| 参数 | 说明 |
|---|---|
q | 可选。在标题、文件夹名、原链接、新链接里模糊匹配(不区分大小写)。 |
limit | 可选。最多返回多少条,不填返回全部(最多 500 条)。 |
curl -sS -G "/api/v1/history" -H "Authorization: Bearer pt_你的Key" \
--data-urlencode "q=https://pan.quark.cn/s/abcd1234" --data-urlencode "limit=1"
{
"ok": true,
"data": [
{"id": "k3m9x2pq7a", "time": "2026-11-21T10:30:00+08:00", "via": "api",
"provider": "夸克", "account": "我的夸克", "title": "某某纪录片 全集", "folder_name": "某某纪录片 全集",
"files": [{"name": "某某纪录片 全集", "is_dir": true, "path": "/转存/电影/某某纪录片 全集"}],
"source": "https://pan.quark.cn/s/abcd1234", "share_url": "https://pan.quark.cn/s/9f8e7d6c5b4a",
"passcode": "", "saved_to": "/转存/电影", "file_count": 1}
]
}
注意记录里的 provider 是中文名,account 是账号名称。
校验 Key
GET/api/v1/me
curl -sS "/api/v1/me" -H "Authorization: Bearer pt_你的Key"
{"ok": true, "data": {"id": "u1v2w3x4y5", "username": "admin", "role": "admin"}}
错误码
| code | HTTP | 含义 | 脚本建议 |
|---|---|---|---|
unauthorized | 401 | 没带 Key,或 Key 无效 / 已重置 | 停止,检查 Key |
forbidden | 403 | Key 所属用户已被停用 | 停止 |
bad_request | 400 / 415 | JSON 格式错误,或没带 Content-Type: application/json | 修正请求 |
bad_link | 400 | 没识别出支持的分享链接 | 跳过这条 |
bad_dir | 400 | dir 不合法 | 修正目录 |
no_account | 400 | 还没有这个网盘的账号 | 先在网页添加账号 |
account_not_found | 404 | account_id 不存在 | 修正 account_id |
account_mismatch | 400 | account_id 和链接不是同一个网盘 | 修正 account_id |
busy | 409 | 你的上一个转存还没结束 | 等 5~10 秒重试 |
share_invalid | 400 | 原分享不存在、已失效或里面没有文件 | 跳过这条 |
bad_passcode | 400 | 提取码错误或缺少提取码 | 跳过或补提取码 |
login_expired | 502 | 网盘账号登录失效 | 停止,到网页重新登录账号 |
capacity_full | 502 | 网盘容量不足 | 停止,清理空间 |
timeout | 504 | 网盘处理超时 | 先查转存记录再决定是否重试,可能已经存进去了 |
transfer_failed | 502 | 其他网盘侧错误,详见 error 和 logs | 记录下来,稍后重试 |
路径或请求方法写错时(如用 GET 调 transfer)会返回纯文本的 404 / 405,不是 JSON。
批量转存脚本(Python)
需要 pip install requests。把链接(或整段分享文案,一行一条)放进 links.txt,结果逐行追加到 result.jsonl,每行是一个完整的接口返回,方便二次处理。
import json, time, requests
BASE = ""
KEY = "pt_你的Key"
DIR = "" # 留空用账号默认目录,例如 "/转存/批量"
H = {"Authorization": "Bearer " + KEY}
STOP = {"unauthorized", "forbidden", "login_expired", "capacity_full", "no_account"}
def transfer(url):
for _ in range(30):
r = requests.post(BASE + "/api/v1/transfer", headers=H, timeout=660,
json={"url": url, "dir": DIR})
d = r.json()
if d.get("code") != "busy":
return d
time.sleep(10) # 上一个还没结束,等一会儿
return d
with open("links.txt", encoding="utf-8") as f, \
open("result.jsonl", "a", encoding="utf-8") as out:
for line in f:
line = line.strip()
if not line:
continue
d = transfer(line)
out.write(json.dumps({"input": line, **d}, ensure_ascii=False) + "\n")
out.flush()
if d["ok"]:
x = d["data"]
print("成功", x["folder_name"], x["share_url"], x["passcode"], sep=" | ")
else:
print("失败", d["code"], d["error"], line, sep=" | ")
if d["code"] in STOP:
break
time.sleep(3) # 给网盘留点间隔,降低风控概率
反向代理超时
一次转存可能超过一分钟。用宝塔 / nginx 反向代理时,请在该站点的反向代理配置里加大超时,否则 nginx 会先返回 504,而服务端仍在继续处理:
proxy_read_timeout 660s; proxy_send_timeout 660s;