ztool-media API 控制台
OCR 识别
媒体处理
任务管理
GET
连通性探针 /ocr/health
只验 Feign → Nacos → PaddleOCR 链路，不跑推理。
发送请求
GET
一键自检 /ocr/ping
服务端生成测试图跑完整识别，返回文本与坐标。
发送请求
POST
上传图片识别 /ocr/upload
图片文件
*
置信度阈值 minScore
开始识别
识别成功后右侧会叠加绘制文本框（rec_polys）。
POST
Base64 识别 /ocr/base64
从图片文件读取 Base64
填入
Base64 内容
*
（可带 data:image 前缀，自动剥离）
文件名 fileName
置信度阈值 minScore
开始识别
GET
健康检查 /media/health
发送请求
GET
运行环境 /media/info
nvenc / hwaccelMode。
发送请求
POST
媒体信息 /media/probe
媒体文件
*
解析
POST
视频压缩 /media/video/compress（异步）
视频文件
*
编码
默认
h264
h265
质量 quality
分辨率 scale
preset
硬件编码
默认(auto)
auto
gpu
cpu
提交任务
POST
HLS 切片 /media/video/slice（异步）
视频文件
*
编码
默认
h264
h265
质量 quality
每片秒数 segTime
分辨率 scale
preset
硬件编码
默认(auto)
auto
gpu
cpu
提交任务
POST
开始录制 /media/record/start（异步）
流地址 url
*
时长 duration（秒）
直接拷贝流
是（省 CPU）
否（重编码）
开始录制
POST
停止录制 /media/record/stop/{taskId}
taskId
*
停止录制
GET
任务列表 /media/tasks
返回条数 limit
查询列表
GET
任务状态 /media/tasks/{taskId}
taskId
*
查询状态
开启轮询(2s)
压缩/切片/录制任务提交后会自动填入这里，可直接轮询到终态。
POST
停止任务 /media/tasks/{taskId}/stop
与上一卡片共用 taskId 输入框。
停止任务
DEL
删除任务 /media/tasks/{taskId}
同时清理输出文件。
删除任务
GET
下载结果 /media/tasks/{taskId}/download
任务 completed 后可下载；浏览器直接保存文件。
下载