PeekAPI

提供当前电脑屏幕截图和录音获取的本地 API，托盘一键切换公开/隐私模式和重启录音

API 说明

端点	方法	功能	参数	成功返回	失败返回
/screen	GET	获取屏幕截图	- r（高斯模糊半径） - k（API 密钥）	- 200 OK，返回 image/jpeg 截图	- 401 Unauthorized：配置了 api_key 且低模糊度密钥错误 - 403 Forbidden：私密模式 - 500 Internal Server Error：截图失败
/record	GET	获取最近录音	无	- 200 OK，返回 audio/wav 录音文件	- 403 Forbidden：私密模式 - 500 Internal Server Error：录音失败
/check	GET/POST	检查是否运行	无	- 200 OK	无

使用

使用发布版本

• 下载 release 的 PeekAPI.exe，在同级目录创建 config.toml 文件，根据配置写入内容，运行程序。
• 若电脑无公网且在远程电脑调用API，需要搭配 frp 使用。
• 可以使用 peekapi --console 运行以在控制台显示日志。
• 日志文件存储在 exe 同目录的 logs 文件夹，可通过系统托盘菜单"打开日志"快速访问。

开发环境运行

1. 安装 Python >= 3.11 和 uv
2. 克隆仓库并安装依赖：

   uv sync

3. 运行程序：

   uv run peekapi          # 标准模式
   uv run peekapi --console  # 调试模式（控制台输出）

打包为 exe

uv sync --group dev
uv run pyinstaller --noconsole --onefile --name peekapi --icon peekapi.ico run.py

配置

示例

[basic]
is_public = true   # 程序启动时默认是否为公开模式
api_key = ""       # 低模糊度下获取截图的key，留空则不需要key
host = "0.0.0.0"   # 监听IP
port = 1920        # 监听端口

[screenshot]
radius_threshold = 3      # 高斯模糊半径阈值，低于该值时调用/screen需要api_key
main_screen_only = false  # 多显示器下是否只截取主显示器

[record]
duration = 20  # 录音时长（秒）
gain = 20      # 音量增益倍数

说明

参数	说明	默认值
is_public	程序启动时默认是否为公开模式	true
api_key	低模糊度下获取截图的密钥，留空则不需要key	""
host	监听 IP	"0.0.0.0"
port	监听端口	1920
radius_threshold	高斯模糊半径阈值，低于该值时获取截屏需要 api_key	3
main_screen_only	多显示器下是否只截取主显示器	false
duration	录音时间（秒）	20
gain	音量增益倍数	20

许可证

本项目采用 MIT 许可证。

Todo

• 支持 Linux 平台（详细方案）

鸣谢

参考了 ChieriBot peek API 的代码