百度网盘文件重命名接口

最后更新：2026-03-06

接口介绍

文件重命名接口：用于批量重命名百度网盘中的文件和文件夹，支持规则化替换、删除关键字、添加前缀后缀等多种操作。支持递归处理、层级控制、类型过滤、扩展名过滤等高级功能，适合批量整理文件名。

特色功能

规则化重命名：支持删除或替换文件名中的关键字

前缀后缀：灵活添加前缀和后缀（后缀在扩展名前）

层级控制：精确控制递归深度（1-2层）

类型过滤：可选择只处理文件、文件夹或全部

扩展名过滤：支持白名单和黑名单过滤

异步处理：大批量操作不阻塞，返回任务ID可查询进度

使用场景

批量去广告：删除文件名中的广告关键字

统一命名：为文件添加统一的前缀或后缀

分类整理：根据文件类型批量重命名

层级管理：只处理特定层级的文件

格式规范：统一文件命名格式

接口信息

接口地址：https://api.ccnccn.cn/baidu_rename?

请求方式：GET

返回格式：JSON

调用频率：1/1S

接口状态：已上线

请求参数

参数名	必选	类型	说明
token	是	string	用户调用接口token，在用户中心-个人信息获取
cookie	是	int	值为cookie管理中的ID，请注意对应关系，填写百度的cookie ID
file_ids	是	string	文件或文件夹ID/路径，逗号分隔。支持文件ID或路径格式（如：/我的文件夹）

重命名规则参数（至少选一个）

参数名	必选	类型	说明
rename_rules	否	string	重命名规则，格式：广告1=广告2,广告3。支持替换（=）和删除如果不提供此参数，将自动从数据库中读取配置的规则如果提供此参数，则优先使用接口参数中的规则
add_prefix	否	string	添加前缀，如：[HD]
add_suffix	否	string	添加后缀（在扩展名前），如：_backup

可选参数

参数名	必选	类型	默认值	说明
match	否	string	fuzzy	匹配模式：fuzzy=模糊匹配，exact=精确匹配
depth	否	int	1	递归层级：0=仅入参本身，1=入参+第一层，2=入参+两层
target	否	string	file	目标类型：file=仅文件，folder=仅文件夹，all=全部
whitelist	否	string	-	扩展名白名单，逗号分隔（如：txt,pdf,zip）。只处理指定扩展名的文件不能与blacklist同时使用
blacklist	否	string	-	扩展名黑名单，逗号分隔（如：exe,dll）。排除指定扩展名的文件不能与whitelist同时使用

参数说明

rename_rules 规则格式

替换规则：旧字符=新字符，将文件名中的"旧字符"替换为"新字符"
删除规则：关键字，删除文件名中的"关键字"
多个规则：用逗号分隔，如：广告1=广告2,广告3
数据库配置：如果不在接口参数中提供 rename_rules，系统会自动从数据库的 user_cookies 表的 ad_names 字段读取规则
优先级：接口参数 > 数据库配置

执行顺序

先应用 rename_rules（删除/替换关键字）
再添加 add_prefix（前缀）
最后添加 add_suffix（后缀，在扩展名前）

层级说明

depth=0：只处理入参本身，不进入文件夹内部
depth=1：处理入参 + 第一层子文件（默认）
depth=2：处理入参 + 第一层 + 第二层子文件

扩展名过滤

白名单和黑名单不能同时使用
扩展名不带点号，如：txt 而不是 .txt
只对文件有效，文件夹不受扩展名过滤影响

响应参数

参数名	类型	说明
success	boolean	是否成功
message	string	提示信息
data	object	返回数据
data.task_id	int	异步任务ID，可用于查询任务状态
data.file_count	int	文件数量
data.depth	int	递归层级
data.target_type	string	目标类型
data.recursive	boolean	是否递归
data.rules_count	int	规则数量（如果有rename_rules）
data.extension_whitelist	array	扩展名白名单（如果有）
data.extension_blacklist	array	扩展名黑名单（如果有）
data.add_prefix	string	前缀（如果有）
data.add_suffix	string	后缀（如果有）

示例请求

示例1：只处理入参文件夹本身

https://api.ccnccn.cn/baidu_rename?token=your_token&cookie=1&file_ids=/我的文件夹&depth=0&rename_rules=旧名称=新名称

效果：

只重命名 /我的文件夹 本身
不会进入文件夹内部

示例2：处理第一层的txt文件

https://api.ccnccn.cn/baidu_rename?token=your_token&cookie=1&file_ids=/我的文件夹&depth=1&target=file&whitelist=txt&rename_rules=安装

效果：

安装说明.txt → 说明.txt
readme.txt → readme.txt（无变化）
安装包.zip → 跳过（不是txt文件）

示例3：处理两层，排除zip文件，添加前缀

https://api.ccnccn.cn/baidu_rename?token=your_token&cookie=1&file_ids=/我的文件夹&depth=2&target=file&blacklist=zip&add_prefix=[备份]

效果：

文档.pdf → [备份]文档.pdf
视频.mp4 → [备份]视频.mp4
压缩包.zip → 跳过（在黑名单中）

示例4：只重命名文件夹

https://api.ccnccn.cn/baidu_rename?token=your_token&cookie=1&file_ids=/我的文件夹&depth=2&target=folder&rename_rules=视频=影视

效果：

视频合集 文件夹 → 影视合集
视频教程 文件夹 → 影视教程
文件不受影响

示例5：组合使用 - 删除关键字+添加前缀后缀

https://api.ccnccn.cn/baidu_rename?token=your_token&cookie=1&file_ids=/我的文件夹&depth=2&target=file&whitelist=txt,pdf&rename_rules=广告,水印&add_prefix=[已处理]&add_suffix=_v2

效果：

广告文档水印.pdf → [已处理]文档_v2.pdf
说明.txt → [已处理]说明_v2.txt
视频.mp4 → 跳过（不在白名单中）

示例6：使用文件ID而不是路径

https://api.ccnccn.cn/baidu_rename?token=your_token&cookie=1&file_ids=123456789&rename_rules=旧名称=新名称

示例7：批量处理多个文件夹

https://api.ccnccn.cn/baidu_rename?token=your_token&cookie=1&file_ids=/文件夹1,/文件夹2,/文件夹3&rename_rules=广告&add_prefix=[清理]

示例8：使用数据库配置的规则（不传rename_rules参数）

https://api.ccnccn.cn/baidu_rename?token=your_token&cookie=1&file_ids=/我的文件夹&depth=2&target=file&add_prefix=[已处理]

说明：

如果数据库中 user_cookies 表的 ad_names 字段配置了规则（如：xxx.com,我的我的）
系统会自动读取并应用这些规则
这样可以避免每次调用都传递相同的规则，更加方便

示例响应

任务提交成功

{
  "success": true,
  "message": "文件重命名任务已提交",
  "data": {
    "task_id": 7015,
    "file_count": 1,
    "depth": 2,
    "target_type": "file",
    "recursive": true,
    "rules_count": 3,
    "extension_whitelist": ["txt", "pdf"],
    "add_prefix": "[已处理]",
    "add_suffix": "_v2"
  }
}

参数错误

{ "success": false, "message": "参数错误: extension_whitelist和extension_blacklist不能同时使用"

}

Cookie失效

{ "success": false, "message": "ID为1的百度网盘Cookie已失效，请到API管理重新设置"

}

任务状态查询

重命名任务是异步执行的，提交后会返回 task_id。可以通过以下方式查询任务状态：

访问任务管理页面查看任务进度
查看日志文件：logs/task_worker.log
任务会自动执行，无需手动触发

错误码说明（持续更新）

错误信息	说明	解决方案
缺少token参数	未提供用户token	在用户中心获取token
参数错误: 缺少cookie参数	未提供Cookie ID	指定要使用的Cookie ID
参数错误: 缺少file_ids参数	未提供文件ID或路径	检查file_ids参数
参数错误: 必须指定至少一个操作	没有指定任何重命名操作	至少提供rename_rules、add_prefix或add_suffix之一
参数错误: depth只能是0、1或2	depth参数值不正确	depth只能是0、1或2
参数错误: target只能是file、folder或all	target参数值不正确	检查target参数
参数错误: whitelist和blacklist不能同时使用	同时使用了白名单和黑名单	只能使用其中一个
ID为X的百度网盘Cookie不存在	Cookie不存在或已删除	需要在Cookie管理中添加百度Cookie
ID为X的百度网盘Cookie已失效	Cookie已失效	需要在Cookie管理中重新设置Cookie
Token无效或账号已被封禁	token错误或账号状态异常	检查token是否有效，或联系站长
调用次数已用完或已过期	超出调用限制或已过期	联系站长加次数和时间
创建异步任务失败	任务创建失败	重试或联系客服

注意事项

请确保Cookie有效，检测状态正常，否则可能导致调用失败
重命名是异步操作，提交后需要等待任务执行完成
大批量重命名会自动添加3秒延迟，避免触发百度网盘频率限制
建议先在小范围测试规则，确认无误后再大批量操作
扩展名过滤只对文件有效，文件夹不受影响
白名单和黑名单不能同时使用
前缀后缀为空字符串时会被跳过
使用浏览器调用时，请勿给参数里带#（浏览器会忽略#后面的所有参数）
每个账号有调用次数和有效期限制，可购买套餐
如遇到BUG或问题，请联系QQ：77931214
重命名规则可以在前端配置后存入数据库，调用时无需传递 rename_rules 参数
如果同时在数据库和接口参数中配置了规则，优先使用接口参数中的规则

最佳实践

1. 批量去广告

# 删除多个广告关键字
rename_rules=广告1,广告2,水印,推广
target=file
depth=2

2. 统一文件命名

# 为所有文件添加日期前缀
add_prefix=[2024-03]
target=file
depth=2

3. 分类整理

# 只处理视频文件，添加分类标签
whitelist=mp4,mkv,avi
add_prefix=[电影]
target=file

4. 批量备份标记

# 为所有文件添加备份后缀
add_suffix=_backup
target=file
depth=1

5. 文件夹规范化

# 统一文件夹命名格式
target=folder
rename_rules=【=,】=
depth=2

更新日志

2026-03-09：

移除 recursive 参数，简化为只用 depth 控制层级
depth 新增 0 选项（只处理入参本身文件夹名称）
参数名简化：match_mode → match，target_type → target，extension_whitelist → whitelist，extension_blacklist → blacklist

2026-03-06：

新增层级控制功能（depth参数）
新增目标类型过滤（target_type参数）
新增扩展名白名单和黑名单过滤
新增前缀后缀功能
优化递归逻辑，支持精确的层级控制
修复BaiduDirectoryService字段名问题
修复统计显示不准确问题

2025-03-05：

接口上线，支持基础重命名功能
支持规则化替换和删除
支持递归处理文件夹