阶跃AI API可自动识别扫描件/PDF文字并生成语义化文件名,Python脚本批量重命名、分类移动至对应子目录。需配置API密钥、安装依赖、处理OCR与摘要、清洗文本、替换非法字符、按关键词创建子文件夹并移动文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要把几十个命名混乱的扫描件、截图或下载文件,按内容主题自动重命名并分类到不同子文件夹——手动一个个看再改名太耗时,用阶跃AI的API识别图片/PDF文字后生成语义化名称,再由Python批量执行重命名与移动操作。
准备阶跃AI API密钥与环境
访问 https://www.jieyueai.com/console 登录账号,在「API管理」页点击「创建新密钥」,复制生成的 【sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx】 字符串。这个密钥必须保密,不能提交到GitHub或共享给他人。
在本地新建一个文件夹,放入待处理的原始文件(支持jpg/png/pdf),再新建一个名为 rename_script.py 的空白Python文件。
打开终端,执行:pip install requests python-magic pillow pdf2image。其中 pdf2image 需要系统已安装poppler(Windows用户请先下载poppler-windows并把bin路径加入系统PATH)。
立即学习“Python免费学习笔记(深入)”;
提取文件文本内容
方法一:对图片类文件(jpg/png)直接调用阶跃AI OCR接口
在脚本中写入请求代码,将图片以base64编码后POST到 https://api.jieyueai.com/v1/ocr,Header中携带 Authorization: Bearer sk-xxx。注意每次请求只传单张图,【超过2MB的图片会返回400错误,需提前用PIL压缩到1500×1500像素以内】。
方法二:对PDF文件先转为单页图片再OCR
用 pdf2image.convert_from_path() 将PDF每页转成PNG,逐页送入OCR接口;若PDF含扫描页和文字页混合,跳过文字页(用 pdfplumber 先检测是否含可选中文本),避免重复识别。
生成语义化文件名
第一步:收集所有OCR返回的文本块,合并去重,剔除“第1页”“机密”“扫描件”等无意义词。
第二步:将清洗后的文本送入阶跃AI的文本摘要接口 https://api.jieyueai.com/v1/chat/completions,system prompt设为:“你是一个文件命名专家,请根据以下内容生成简洁、不含空格和特殊符号的中文文件名(限12字内),仅输出名称,不要解释。示例输入:‘报销单 2024年3月 张三 交通费’ → 输出:张三202403交通报销”。
第三步:接收模型返回的纯文本名称,用正则 re.sub(r'[\/*?:"|]', '_', name) 替换非法字符,末尾自动追加原扩展名,如“张三202403交通报销.pdf”。
按规则创建子目录并移动文件
遍历所有生成的新文件名,提取关键词(如“合同”“发票”“简历”“会议纪要”),匹配预设关键词表:
合同 → /contracts/,发票 → /invoices/,简历 → /resumes/,会议纪要 → /meetings/,其他 → /others/
用 os.makedirs(path, exist_ok=True) 创建对应子目录,再用 shutil.move(old_path, new_path) 执行移动。这一步操作起来很简单,直接把文件拖进去就行。
全部移动完成后,原始文件夹里只剩一个空的 rename_script.py 文件和日志文件 rename_log.txt。


















