ReClip无头用法：Python脚本批量调用/api/download实战示例

ReClip无头用法Python脚本批量调用/api/download实战示例【免费下载链接】reclipDownload videos from almost any website. Lightweight, self-hosted media downloader with a clean web UI.项目地址: https://gitcode.com/GitHub_Trending/rec/reclipReClip 是一个开源、自托管的视频下载器自带简洁 Web 界面支持从 1000 网站下载视频MP4或音频MP3。很多新手只知道用网页粘贴链接其实它的后端暴露了完整的 REST API——用 Python 脚本无头调用/api/download就能实现批量自动下载轻松接入定时任务或 CI 流水线。一、为什么需要无头用法️Web 界面适合单个视频、手动操作API 无头模式适合批量 URL、脚本化、自动化场景好消息是ReClip 整个后端就是 app.py 一个约 195 行的 Python 文件只依赖 requirements.txt 中的 2 个包Flask yt-dlp接口极简几乎零学习成本。二、一键启动2 分钟跑起 ReClip 服务无头调用的前提是服务在运行。先确保机器上安装了python3、yt-dlp、ffmpeg然后git clone https://gitcode.com/GitHub_Trending/rec/reclip cd reclip ./reclip.shreclip.sh 会自动检查依赖、创建虚拟环境并启动服务默认监听http://localhost:8899可通过PORT环境变量修改端口。偏好 Docker 的话直接用 Dockerfile 和 docker-compose.ymldocker compose up -d三、5 个核心 API 一览所有接口定义在 app.pyWeb 前端 templates/index.html 调用的也是同一套接口端点方法用途关键参数/api/infoPOST获取视频信息 清晰度列表url/api/playlistPOST展开播放列表为单条视频 URLurl/api/downloadPOST启动下载任务异步url、format、format_id/api/status/job_idGET轮询任务状态—/api/file/job_idGET下载已完成的文件—关键参数说明见 app.pyformatvideo输出 MP4audio提取 MP3format_id可选清晰度 ID可先调/api/info拿到formats列表再指定title可选用于生成更友好的文件名四、无头下载三步流程/api/download是异步设计提交后立即返回job_id下载在后台线程中执行app.py所以脚本只需三步走提交任务→POST /api/download拿到job_id轮询状态→GET /api/status/job_id等待status变为done或error获取文件→GET /api/file/job_id拿到文件字节流五、实战Python 批量下载脚本完整示例如下约 30 行即可跑通支持视频/音频两种模式import time from pathlib import Path import requests BASE http://localhost:8899 def download_one(url: str, out_dir: Path, fmtvideo, title) - Path: # 1️⃣ 提交任务立即拿到 job_id job_id requests.post(f{BASE}/api/download, json{ url: url, format: fmt, title: title, }).json()[job_id] # 2️⃣ 每秒轮询一次状态 while True: s requests.get(f{BASE}/api/status/{job_id}).json() if s[status] done: break if s[status] error: raise RuntimeError(s[error]) time.sleep(1) # 3️⃣ 拉取文件并保存 out out_dir / (s.get(filename) or f{job_id}.mp4) out.write_bytes(requests.get(f{BASE}/api/file/{job_id}).content) return out URLS [ https://www.youtube.com/watch?vxxx1, https://www.tiktok.com/user/video/123, ] out_dir Path(./downloads); out_dir.mkdir(exist_okTrue) for u in URLS: p download_one(u, out_dir, fmtaudio) # 想下视频改 fmtvideo print(saved:, p)进阶技巧指定清晰度先调POST /api/info读取返回的formats如{id: 22, label: 720p}再作为format_id传给/api/download批量抓播放列表调POST /api/playlist可把列表页 URL 展开为单条视频列表app.py直接放进URLS循环即可错误容错脚本中error分支会抛出服务器返回的最后一条 stderr建议在循环里加try/except跳过失败项继续六、常见问题与注意事项 ⚠️超时限制单个下载任务上限5 分钟timeout300超长视频建议走 Docker 部署并调大 gunicorn 超时Dockerfile 已预设为 600 秒文件命名传入的title会自动过滤非法字符并截断至 100 字符app.py不传则以job_id命名临时文件自动清理任务完成后只保留目标格式的 mp4/mp3其余中间文件自动删除并发每次提交都会启动一个后台线程批量下载时建议串行提交如上脚本避免同时压满带宽合规提醒ReClip 仅限个人使用请尊重版权与平台服务条款见 README.md 免责声明总结ReClip 的无头用法比想象中简单——一个POST、一个轮询、一个文件下载不到 40 行 Python 就能把批量视频下载器嵌入任何自动化流程。项目采用 MIT 协议LICENSE放心自托管吧 【免费下载链接】reclipDownload videos from almost any website. Lightweight, self-hosted media downloader with a clean web UI.项目地址: https://gitcode.com/GitHub_Trending/rec/reclip创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考