褐马智能边缘计算云-Edge 对接文档

0. 接入准备

KEY="<管理端密钥>"
BASE="https://desk.xiaohetx.cn/api/edge"

H=(-H "X-Admin-Key: $KEY" -H "Content-Type: application/json")

post_task() {   # post_task <类型> <payload-json> <幂等键> [device_id 可省略] [超时秒]
  local type="$1" payload="$2" ikey="$3" dev="$4" tout="${5:-120}"
  local body="{\"type\":\"$type\",\"payload\":$payload,\"timeout_sec\":$tout,\"idempotency_key\":\"$ikey\""
  [ -n "$dev" ] && body="$body,\"device_id\":\"$dev\""     # 传了才指定, 不传就自动派发
  curl -s -X POST "${H[@]}" -d "$body}" "$BASE/admin/tasks/"
}

poll_task() {   # poll_task <taskId>：打印状态直到终态并输出任务全文
  local tid="$1"
  for i in $(seq 1 45); do
    R=$(curl -s "${H[@]}" "$BASE/admin/tasks/$tid/")
    echo "[$i] $(echo "$R" | grep -o '"status":"[a-z]*"' | head -1)"
    echo "$R" | grep -q '"status":"pending"\|"status":"dispatched"\|"status":"running"' || { echo "$R"; return 0; }
    sleep 2
  done
  echo POLL_TIMEOUT; return 1
}

1. 术语表

正文与参数表中出现的缩写与专有名词，在此统一解释一次。

2. 能力速查表

共 192 项（1–53 为基础对接能力；54–192 为 2026-10 增补的全量能力，含音频/容器/编辑/图像/文件/供应商/推理/OCR/安全/流）。机器可读版本：GET admin/capabilities/。

能力下线或替换时，会先在本表标注并保留至少 6 个月过渡期，再移除。

1. vision.image_labeling — 图像打标

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"vision","func":"image_labeling","args":["ocr_test.png",0.5]}' "acme-label-001"

• args 为平铺风格，直接写 ["路径", 0.5]，不要多包一层

2. vision.face_detection — 人脸检测

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"vision","func":"face_detection","args":["人脸图.png"]}' "acme-face-001"

• 无人脸时返回空数组，属正常结果不是错误

3. vision.translate_text — 离线文本翻译

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"vision","func":"translate_text","args":["hello","zh","en"]}' "acme-tr-001"

• 完全离线，走端侧模型，不产生外部 API 调用与费用

4. vision.barcode_scan — 条码扫描

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"vision","func":"barcode_scan","args":["条码图.png"]}' "acme-bar-001"

• 支持 QR_CODE / CODE_128 / EAN_13 等常见格式

5. vision.identify_language — 语种识别

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"vision","func":"identify_language","args":["hello world"]}' "acme-lang-001"

• 可用于翻译前的语种预判，避免误指定源语种

6. system.ocr — 离线图片文字识别

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"system","func":"ocr","args":["ocr_test.png","Latin"]}' "acme-ocr-001" 120

• 输出文件名规则：a.png → a.png.ocr.txt
• 识别在本地完成，不产生任何外部 API 调用与费用

7. image.resize — 缩放图片

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"image","func":"resize","args":["ocr_test.png",640,480]}' "acme-rs-001"

• 宽高不能同时 <=0，否则报 resize requires width or height > 0

8. image.compress — 压缩图片

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"image","func":"compress","args":["ocr_test.png",0.6,"jpeg"]}' "acme-cp-001"

• 质量越低压得越狠，<0.3 时文字类图片可读性明显下降

9. image.crop — 裁剪图片

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"image","func":"crop","args":["ocr_test.png",0,0,800,600]}' "acme-cr-001"

• 超出原图范围会报错，裁剪前建议先 image.resize 归一化

10. image.rotate — 旋转图片

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"image","func":"rotate","args":["ocr_test.png",90]}' "acme-rt-001"

• 90/270 度会交换宽高

11. image.flip — 翻转图片

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"image","func":"flip","args":["ocr_test.png","horizontal"]}' "acme-fp-001"

• 参数拼错不会报错而是静默按 vertical 处理，务必核对

12. image.format_convert — 转换图片格式

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"image","func":"format_convert","args":["ocr_test.png","webp"]}' "acme-fc-001"

• 未知格式会回落到 JPEG

13. image.thumbnail — 生成缩略图

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"image","func":"thumbnail","args":["ocr_test.png",256]}' "acme-th-001"

• E 组 imagehw.thumbnail（#18）为硬件实现，批量场景优先用它

14. imagehw.batch_resize — 批量缩放图片

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imagehw","func":"batch_resize","args":[["/data/in","/data/out",640,480,85]]}' "acme-br-001" 300

• 输入目录不存在会返回 error，先用 file.download 或 system.download_file 备好素材

15. imagehw.rotate — 硬件旋转图片

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imagehw","func":"rotate","args":[["a.png",90]]}' "acme-hrt-001"

• 与 D 组 image.rotate（#10）结果一致，本项走硬件通路、更快

16. imagehw.convert_format — 硬件转换格式

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imagehw","func":"convert_format","args":[["a.png","png"]]}' "acme-hcf-001"

• 输出为同目录新文件，原图保留
• 格式取值 jpeg / png / webp；写入不存在的格式会失败

17. imagehw.watermark — 添加水印

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imagehw","func":"watermark","args":[["a.png","褐马边缘云"]]}' "acme-wm-001"

• 文字为空字符串仍会执行，输出与原图等效

18. imagehw.thumbnail — 硬件缩略图

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imagehw","func":"thumbnail","args":[["a.png",256]]}' "acme-ht-001"

• 默认最长边 256，等比缩放；输出为同目录新文件

19. imagehw.jpeg_encode — 硬件 JPEG 编码

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imagehw","func":"jpeg_encode","args":[["a.png",90]]}' "acme-je-001"

• 质量范围 1–100，数值越高质量越好、体积越大

20. gpu.blur — 高斯模糊

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"gpu","func":"blur","args":["a.png",8]}' "acme-blur-001"

• 走 Skia GPU 通路，输出为同目录新文件

21. gpu.grayscale — 转灰度

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"gpu","func":"grayscale","args":["a.png"]}' "acme-gray-001"

• 输出为同目录新文件，原图保留

22. gpu.sharpen — 锐化

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"gpu","func":"sharpen","args":["a.png",1.2]}' "acme-sp-001"

• 强度范围 0–2；强度过高会产生明显噪点
• 输出为同目录新文件，原图保留

23. gpu.tflite_gpu — GPU 运行 TFLite 模型

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"gpu","func":"tflite_gpu","args":["/files/models/mobilenet.tflite","cat.jpg"]}' "acme-tfl-001" 180

• 返回原始输出张量（shape + 小端 float32），需自行解码后处理
• TFLite GPU 依赖未集成时返回 result.error；纯 CPU 路径请用 rknn.infer（#34）

24. video.extract_thumbnail — 提取视频封面

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"video","func":"extract_thumbnail","args":["clip.mp4",1000,80]}' "acme-vt-001" 120

• 单帧抽取典型耗时 0.5 秒量级

25. video.extract_frames — 批量抽帧

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"video","func":"extract_frames","args":["clip.mp4",[0,1000,2000]]}' "acme-vf-001" 180

• I 组 videohw.extract_frames（#27）为硬件解码版本，长视频优先用它

26. video.get_metadata — 读取视频信息

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"video","func":"get_metadata","args":["clip.mp4"]}' "acme-vm-001"

• 不解码画面，只读取容器元信息，耗时与视频长度无关

27. videohw.extract_frames — 硬件批量抽帧

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videohw","func":"extract_frames","args":[["clip.mp4",[0,1000,2000],"/data/out"]]}' "acme-hvf-001" 180

• timesMs 必须是数组，传数字会报 requires timesMs: number[]

28. videohw.transcode — 硬件视频转码

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videohw","func":"transcode","args":[["src.mp4","dst.mp4",1280,720,4000000]]}' "acme-tc-001" 600

• 长视频转码耗时长，务必把 timeout_sec 调大（本例 600s）

29. videohw.get_metadata — 硬件读取视频信息

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videohw","func":"get_metadata","args":[["clip.mp4"]]}' "acme-hvm-001"

• 不解码画面，只读取容器元信息，耗时与视频长度无关

30. speech.transcribe — 实时麦克风转文字

• 请求头需带有效的 X-Admin-Key
• 设备需为 arm64-v8a；先跑 speech.status 确认原生模块已链接
• 需已授予 RECORD_AUDIO；模型需已同步

post_task script '{"module":"speech","func":"transcribe","args":[5]}' "acme-asr-001" 60

• 需 RECORD_AUDIO 权限；headless 任务内无法弹窗授权，未授权时返回明确错误，需前台或 MDM 授权
• 先执行 system.sync_models（#37）拉取 paraformer-streaming-zh，否则报「流式语音模型未同步」
• 5 秒录音端到端约 9.5 秒，耗时主要在流式解码

31. speech.transcribe_file — 音频文件转文字

• 请求头需带有效的 X-Admin-Key
• 设备需为 arm64-v8a；先跑 speech.status 确认原生模块已链接
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"speech","func":"transcribe_file","args":["a.wav"]}' "acme-asrf-001" 120

• 与 #30 的区别：本项是整句离线解码（快），#30 是麦克风流式（实时）
• 非 arm64-v8a 设备会返回「端侧语音识别不可用」并带上 ABI

32. speech.status — 语音模块自检

• 请求头需带有效的 X-Admin-Key
• 设备需为 arm64-v8a；先跑 speech.status 确认原生模块已链接

post_task script '{"module":"speech","func":"status","args":[]}' "acme-asrs-001"

• 排障第一步：先跑本项确认原生模块已链接，再跑 #30/#31

33. speech.release — 释放语音模型

• 请求头需带有效的 X-Admin-Key
• 设备需为 arm64-v8a；先跑 speech.status 确认原生模块已链接

post_task script '{"module":"speech","func":"release","args":[]}' "acme-asrl-001"

• released=0 表示当前没加载任何模型，非错误

34. rknn.infer — RKNN 模型推理

• 请求头需带有效的 X-Admin-Key
• 模型需已同步，见 system.sync_models
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"rknn","func":"infer","args":["/files/models/mobilenetv2-12.rknn","cat.jpg"]}' "acme-inf-001" 120

• 首次调用会自动加载模型；显式预热用 rknn.load_model（#35）
• 单次推理超时 10 秒；timeout_sec 需大于该值
• 640 检测模型请优先用 rknn.detect（#52），原始张量有 705600 浮点不适合直接回传

35. rknn.load_model — 加载 RKNN 模型

• 请求头需带有效的 X-Admin-Key
• 模型需已同步，见 system.sync_models
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"rknn","func":"load_model","args":["/files/models/yolov8n-640@2.0.0-rk3576-int8/model.rknn"]}' "acme-lm-001" 120

• 模型须先由 system.sync_models（#37）拉到 files/models/
• 批量任务开始前预热，可省去首个任务的加载时间

36. rknn.release — 释放 NPU 模型

• 请求头需带有效的 X-Admin-Key
• 模型需已同步，见 system.sync_models
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"rknn","func":"release","args":[]}' "acme-rknn-001"

• 不释放也不影响后续加载；长时间连续调用建议释放

37. system.sync_models — 同步 AI 模型

• 请求头需带有效的 X-Admin-Key

post_task script '{"module":"system","func":"sync_models","args":[]}' "acme-syncm-001" 900

• 幂等：当前版本摘要一致则直接跳过，不重复下载，因此第二次执行通常 20s 内完成
• 模型文件不落在业务服务器上，只存对象存储；版本目录 files/models/{name}@{version}/
• 回滚 = 把 current 指针指回旧版本，无需重新下载

52. rknn.detect — YOLO 目标检测（数据级）

• 请求头需带有效的 X-Admin-Key
• 模型需已同步，见 system.sync_models
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"rknn","func":"detect","args":["/files/models/yolov8n-640@2.0.0-rk3576-int8/model.rknn","bus.jpg",{"conf":0.25,"iou":0.45,"max":100}]}' "acme-det-001" 120

• 640 分辨率下单帧耗时：INT8 约 160 毫秒，FP16 约 220 毫秒
• 输入先经标准 letterbox（等比 + 居中 + 114 灰边）进模型，NMS 后映射回原图，result.letterbox 附换算参数备查
• 单输出 [1,84,8400] 格式的 INT8 模型不可用于本项：坐标与类别分共享量化 scale，类别分会被压成 0.5；请用官方 9 输出模型，或改用 FP16
• FP16 模型（yolov8n-640@2.0.0-rk3576-fp16）分数精度明显更高，真机 person 约 0.89，与 fp32 基线一致

53. rknn.infer fullOutput 模式 — 取回完整原始张量

• 请求头需带有效的 X-Admin-Key
• 模型需已同步，见 system.sync_models
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"rknn","func":"infer","args":["/files/models/mobilov2-12.rknn","cat.jpg",{"fullOutput":true}]}' "acme-full-001" 180

• 需 WS 单包预算 ≥10MB：低于 2.0.53 的设备单包上限为 1 MB，会失败
• 仅用于调试；正式调用请用 rknn.detect

38. crypto.gen_keys — 生成密钥对

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」

post_task script '{"module":"crypto","func":"gen_keys","args":[["rt1","aes"]]}' "acme-gk-001"

• 重复对同一 alias 生成会覆盖旧密钥，先确认没有依赖该 alias 的密文
• RSA 默认 2048 位

39. crypto.aes_encrypt — AES-GCM 加密

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 须先用 crypto.gen_keys 生成同名 alias 的密钥

post_task script '{"module":"crypto","func":"aes_encrypt","args":[["rt1","aGVsbG8="]]}' "acme-ae-001"

• 明文必须先 base64；ivBase64 必须与密文一同保存，解密时要用
• 1 KB 明文端到端约 44 毫秒

40. crypto.aes_decrypt — AES-GCM 解密

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 须先用 crypto.gen_keys 生成同名 alias 的密钥

post_task script '{"module":"crypto","func":"aes_decrypt","args":[["rt1","3q2+7w==","kQ=="]]}' "acme-ad-001"

• 密文被篡改会校验失败，这是 AES-GCM 的设计目的，不要当作故障

41. crypto.rsa_sign — RSA 签名

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 须先用 crypto.gen_keys 生成同名 alias 的密钥

post_task script '{"module":"crypto","func":"rsa_sign","args":[["sig1","hello"]]}' "acme-rs-001"

• 签名不可复现（同消息每次不同），验签须用本返回值

42. crypto.rsa_verify — RSA 验签

• 请求头需带有效的 X-Admin-Key
• payload.args 必须是双层数组，见 §0「两种 args 传参约定」
• 须先用 crypto.gen_keys 生成同名 alias 的密钥

post_task script '{"module":"crypto","func":"rsa_verify","args":[["sig1","hello","a1b2c3…"]]}' "acme-rv-001"

• valid=false 表示消息被改或签名不属于该 key，别名写错也会这样

43. rag.ingest — 文档入库

• 请求头需带有效的 X-Admin-Key

post_task script '{"module":"rag","func":"ingest","args":["边缘计算把算力放在离数据源更近的位置","mydoc"]}' "acme-rag-001" 180

• 知识库存在端侧，设备间不共享；清缓存不会删知识库

44. rag.search — 语义检索

• 请求头需带有效的 X-Admin-Key

post_task script '{"module":"rag","func":"search","args":["算力放在哪里",3]}' "acme-rag-002" 120

• 先 #43 入库再检索；空库时返回空数组不报错

45. rag.answer — 基于知识库问答

• 请求头需带有效的 X-Admin-Key

post_task script '{"module":"rag","func":"answer","args":["算力放在哪里",3]}' "acme-rag-003" 180

• 答案基于端侧知识库，不调用外部大模型 API

46. batch.process — 通用批量子集处理

• 请求头需带有效的 X-Admin-Key

post_task script '{"module":"batch","func":"process","args":[{"batch_func":"ocr","data":["a.png","b.png"]}]}' "acme-bp-001" 300

• batch_func 未知时返回 unknown batch_func
• 日常用 #47/#48/#49 的便捷入口即可，本项主要给编排平台用

47. batch.ocr — 批量图片识别文字

• 请求头需带有效的 X-Admin-Key

post_task script '{"module":"batch","func":"ocr","args":[["a.png","b.png"],"Latin"]}' "acme-bocr-001" 180

• 单张失败不阻断整批，失败项在 items 里带错误原因

48. batch.image_batch — 批量图片处理

• 请求头需带有效的 X-Admin-Key
• args[1] 操作名必填

post_task script '{"module":"batch","func":"image_batch","args":[["a.png","b.png"],"resize",{"width":640,"height":480}]}' "acme-bib-001" 300

• args[1] 必填，缺失会报 width and height must be > 0 这类误导性错误
• 带 options 时务必同时给 width/height

49. batch.hash_batch — 批量文件哈希

• 请求头需带有效的 X-Admin-Key

post_task script '{"module":"batch","func":"hash_batch","args":[["model.rknn","tokens.txt"]]}' "acme-bhash-001" 180

• 大文件（数百 MB）耗时较长，timeout_sec 建议 300s 以上

50. file.upload — 端上文件上传七牛

• 请求头需带有效的 X-Admin-Key
• localPath 需为端上已存在的文件

post_task file '{"action":"upload","localPath":"ocr_test.png.ocr.txt","filename":"result.txt"}' "acme-up-001" 180

• key 由端侧生成、不可指定，只能落在本设备命名空间下，隔离多设备互访
• 常见组合：先用 OCR 得到 a.png.ocr.txt，再用本项回传，可比对任务结果与文件内容是否一致

51. file.download — 下载七牛文件到端上

• 请求头需带有效的 X-Admin-Key
• key 须位于本设备命名空间 edge/{device_id}/ 下

post_task file '{"action":"download","key":"edge/edge_xxx/<uuid>/result.txt","localPath":"back.txt"}' "acme-dn-001" 180

• 跨命名空间会 403：拉取 shared-test/ 等公共素材请用 test_flow 或先 file.upload 到本设备命名空间
• 私有 bucket 的签名 URL 由端侧凭据自动生成，不要手工拼 URL

3. 任务状态与限制

3.1 任务状态

每条任务有一个 status，按下面的顺序推进。success / failed / timeout / cancelled 为终态，进入终态后不再变化。

只有 pending 与 dispatched 可被 POST admin/tasks/<id>/cancel/ 取消；已进入 running 的任务无法取消。

3.2 幂等提交

idempotency_key 由调用方生成，全局唯一，最大 128 字符。用同一个键重复提交只会得到同一条任务，不会重复执行。这一行为对全部能力一致，与具体能力无关。

• 去重记录保留 24 小时，从该任务进入终态后开始计时
• 网络超时后重发时沿用原键即可安全重试
• 需要重复执行同一动作时，换一个新的键
• 不带该字段时不去重，每次提交都是新任务

3.3 限流

按调用方密钥计数，固定窗口。

超限返回 429。等待当前窗口结束后重发，不要立即重试。轮询任务状态同样计入限流，建议间隔 2 秒以上。

3.4 超时

timeout_sec 取值 1–86400 秒，默认 300 秒。超时后任务进入 timeout 终态。

• 后端按 timeout_sec 加少量余量后判定超时，长耗时能力需显式调大：视频转码 600 秒、模型同步 900 秒、批量处理 300 秒
• 单次模型推理在节点侧的固定超时为 10 秒，timeout_sec 需大于该值
• 轮询建议用退避方式：首次 2 秒，之后每次 ×1.5，上限 15 秒

54. audiohw.probe_audio — 音频编码能力探测

• 请求头需带有效的 X-Admin-Key

post_task script '{"module":"audiohw","func":"probe_audio","args":[[]]}' "acme-ap-001"

• 本组 args 须双层数组，见 §0。
• RK3576S 音频为软件编码，无硬件 AAC/AMR

55. audiohw.get_metadata — 读取音频信息

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"audiohw","func":"get_metadata","args":[["a.wav"]]}' "acme-am-001"

• 本组 args 须双层数组，见 §0。
• 相对路径自动 resolve 到应用文档目录

56. audiohw.extract_audio — 提取音频

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"audiohw","func":"extract_audio","args":[["in.mp4","out.m4a","aac",128000]]}' "acme-ea-001" 180

• 本组 args 须双层数组，见 §0。
• target=copy 且容器允许时零重编码

57. audiohw.transcode — 音频转码

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"audiohw","func":"transcode","args":[["a.wav","b.m4a","aac",128000]]}' "acme-at-001" 300

• 本组 args 须双层数组，见 §0。
• 视频转音频用 replace_audio，本项只收纯音频

58. audiohw.denoise — 音频降噪

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"audiohw","func":"denoise","args":[["in.wav","out.wav",12]]}' "acme-dn-001" 300

• 本组 args 须双层数组，见 §0。
• 第三参须传数字；STFT 谱减为真实 DSP

59. audiohw.remove_audio — 剥离音轨

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"audiohw","func":"remove_audio","args":[["in.mp4","mute.mp4"]]}' "acme-ra-001" 120

• 本组 args 须双层数组，见 §0。
• 纯 stream-copy 零重编码

60. audiohw.replace_audio — 替换音轨

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"audiohw","func":"replace_audio","args":[["v.mp4","a.wav","out.mp4","aac",128000]]}' "acme-rpa-001" 180

• 本组 args 须双层数组，见 §0。
• 参数顺序固定 [video,audio,dst,target,bitrate]，视频不重编码

61. audiohw.mix_audio — 混音

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"audiohw","func":"mix_audio","args":[["v.mp4","b.wav","out.mp4",1,1,"aac",128000]]}' "acme-ma-001" 180

• 本组 args 须双层数组，见 §0。
• 第二源会被重采样/下混到基底布局；增益为线性幅度（0.5=-6dB）

62. audiohw.set_volume — 调音量

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"audiohw","func":"set_volume","args":[["in.mp4","out.mp4",0.5,false,"aac",128000]]}' "acme-sv-001" 180

• 本组 args 须双层数组，见 §0。
• volume 必须为 number；有视频轨时视频 stream-copy

63. remuxhw.avinfo — 媒体探针

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"remuxhw","func":"avinfo","args":[["in.mp4"]]}' "acme-av-001"

• 本组 args 须双层数组，见 §0。
• 全量探针：编码标准/profile/level/分辨率/帧率/旋转/码率/B 帧

64. remuxhw.remux — 容器重封装

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"remuxhw","func":"remux","args":[["in.mp4","out.webm",{"keepVideo":true,"keepAudio":true}]]}' "acme-rx-001" 120

• 本组 args 须双层数组，见 §0。
• 零重编码 bit-exact；FLV 容器原生拒绝

65. remuxhw.segment — 无损切片

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"remuxhw","func":"segment","args":[["in.mp4","/data/out",{"durationMs":60000}]]}' "acme-sg-001" 180

• 本组 args 须双层数组，见 §0。
• GOP 对齐无损切，每片起于关键帧；单片失败不整体失败，看 segments[].error

66. remuxhw.transcode — 视频转码

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"remuxhw","func":"transcode","args":[["in.mp4","out.mp4",{"videoCodec":"h265","bitrate":4000000}]]}' "acme-tc2-001" 600

• 本组 args 须双层数组，见 §0。
• RK3576S VPU 硬编，仅 H.264/H.265；调用前可用 list_encoders 校验

67. remuxhw.private_encrypt — 私有加密

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"remuxhw","func":"private_encrypt","args":[["in.mp4","enc.mp4",{"drmComKey":"BASE64URL","drmFileKey":"BASE64URL"}]]}' "acme-pe-001" 180

• 本组 args 须双层数组，见 §0。
• 零重编码；容器保持可解析，对应 DORA 价格页 copy 档

68. remuxhw.private_decrypt — 私有解密

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"remuxhw","func":"private_decrypt","args":[["enc.mp4","back.mp4",{"drmComKey":"BASE64URL"}]]}' "acme-pd-001" 180

• 本组 args 须双层数组，见 §0。
• 先剥文件层再逐样本解，密钥须与加密一致

69. remuxhw.list_encoders — 编码器清单

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"remuxhw","func":"list_encoders","args":[[]]}' "acme-le-001"

• 本组 args 须双层数组，见 §0。
• 无参；转码前用它校验请求合法性

70. videoedithw.watermark — 视频水印

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"watermark","args":[["in.mp4","out.mp4",{"layers":[{"type":"text","text":"EDGE","position":"bottomRight"}]}]]}' "acme-vw-001" 300

• 本组 args 须双层数组，见 §0。
• options.layers 为空直接返回错误

71. videoedithw.concat_video — 视频拼接

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"concat_video","args":[[["a.mp4","b.mp4"],"out.mp4",{"mode":"reencode"}]]}' "acme-vc-001" 600

• 本组 args 须双层数组，见 §0。
• copy 要求参数一致否则用 reencode

72. videoedithw.concat_audio — 音频拼接

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"concat_audio","args":[[["a.m4a","b.m4a"],"out.m4a",{}]]}' "acme-vca-001" 300

• 本组 args 须双层数组，见 §0。
• 空列表直接返回错误

73. videoedithw.add_subtitle — 字幕处理

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"add_subtitle","args":[["in.mp4","out.mp4",{"mode":"sidecar","subtitlePath":"/data/sub.srt"}]]}' "acme-vs-001" 300

• 本组 args 须双层数组，见 §0。
• sidecar 无损；embed 烧录重编码

74. videoedithw.mix_audio — 视频混音

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"mix_audio","args":[["base.mp4","out.mp4",{"audioPath":"extra.wav"}]]}' "acme-vm-001" 300

• 本组 args 须双层数组，见 §0。
• 缺 audioPath 直接返回错误；视频恒流拷

75. videoedithw.replace_audio — 视频换音轨

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"replace_audio","args":[["v.mp4","out.mp4",{"audioPath":"new.wav"}]]}' "acme-vra-001" 300

• 本组 args 须双层数组，见 §0。
• 缺 audioPath 直接返回错误；视频恒流拷

76. videoedithw.mosaic — 马赛克

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"mosaic","args":[["in.mp4","out.mp4",{"rects":[{"x":10,"y":10,"w":80,"h":80}]}]]}' "acme-vmo-001" 300

• 本组 args 须双层数组，见 §0。
• 缺 rects 直接返回错误

77. videoedithw.remove_streams — 轨道过滤

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"remove_streams","args":[["in.mp4","out.mp4",{}]]}' "acme-vrs-001" 120

• 本组 args 须双层数组，见 §0。
• 默认 options 即去全部文本轨

78. videoedithw.list_capabilities — 编辑能力探测

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"videoedithw","func":"list_capabilities","args":[[]]}' "acme-vlc-001"

• 本组 args 须双层数组，见 §0。
• 无参；派发前先探测拒绝不可能任务

79. imageproc.animate — 生成动图

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"animate","args":[[["f1.png","f2.png"],120,0,512,"out.gif"]]}' "acme-an-001" 120

• 本组 args 须双层数组，见 §0。
• 手写 GIF89a+LZW（Android 无 GIF 编码器）

80. imageproc.avif_compress — AVIF 压缩

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"avif_compress","args":[["in.jpg","out.avif","auto",80]]}' "acme-avif-001" 120

• 本组 args 须双层数组，见 §0。
• 需 API 31+ 且有 AV1 图像编码器；Android 11 返回拒答

81. imageproc.blind_watermark — 盲水印嵌入

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"blind_watermark","args":[["in.jpg","text","hello","out.png",0]]}' "acme-bw-001" 60

• 本组 args 须双层数组，见 §0。
• DCT 域不可见水印；输出 PNG（JPEG 重编码会破坏载荷）

82. imageproc.blind_watermark_extract — 盲水印提取

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"blind_watermark_extract","args":[["out.png"]]}' "acme-bwe-001" 30

• 本组 args 须双层数组，见 §0。
• 缩放/低质量 JPEG 会损坏载荷

83. imageproc.capabilities — 图像能力探测

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"capabilities","args":[[]]}' "acme-ipc-001"

• 本组 args 须双层数组，见 §0。
• 原生为 0 参方法，多传 null 会触发 TurboModule 参数校验失败

84. imageproc.exif — 读取 EXIF

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"exif","args":[["a.jpg"]]}' "acme-ex-001"

• 本组 args 须双层数组，见 §0。
• 缺失数值标签为 0、字符串为 null

85. imageproc.heif_compress — HEIF 压缩

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"heif_compress","args":[["in.jpg","out.heic","auto",80]]}' "acme-heif-001" 120

• 本组 args 须双层数组，见 §0。
• 经 MediaCodec+MediaMuxer 编码

86. imageproc.image_ave — 平均色调

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"image_ave","args":[["a.jpg"]]}' "acme-ave-001"

• 本组 args 须双层数组，见 §0。
• 大图原生降采样，均值不变

87. imageproc.image_density — 读写 DPI

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"image_density","args":[["a.jpg",300,"out.jpg"]]}' "acme-den-001" 60

• 本组 args 须双层数组，见 §0。
• 写出支持 JFIF APP0/PNG pHYs 并回读校验

88. imageproc.image_exif_retain — EXIF 保留/剥离

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"image_exif_retain","args":[["a.jpg",{"mode":"keep"},"out.jpg"]]}' "acme-er-001" 60

• 本组 args 须双层数组，见 §0。
• 字节级复制后仅改元数据，不重编码图像

89. imageproc.image_info — 图片信息

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"image_info","args":[["a.jpg"]]}' "acme-ii-001"

• 本组 args 须双层数组，见 §0。
• 容器级事实，非解码后位图尺寸

90. imageproc.image_mogr2 — 图片规范化

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"image_mogr2","args":[["a.jpg",{"limitWidth":1920,"quality":85},"out.jpg"]]}' "acme-mg-001" 60

• 本组 args 须双层数组，见 §0。
• 渐进式是否应用以平台编码器上报为准

91. imageproc.image_mogr2_ext — 图片规范化扩展

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"image_mogr2_ext","args":[["a.jpg",{"limitWidth":1920,"density":300},"out.jpg"]]}' "acme-mge-001" 60

• 本组 args 须双层数组，见 §0。
• 为 mogr2 扩展（密度/EXIF 保留等），原函数保持不变

92. imageproc.image_slim — 图片瘦身

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"image_slim","args":[["a.jpg","out.jpg",200000]]}' "acme-sl-001" 60

• 本组 args 须双层数组，见 §0。
• 二分搜索能装入上限的 JPEG 质量，不够才降分辨率

93. imageproc.jpeg_progressive — 渐进 JPEG

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"jpeg_progressive","args":[["a.jpg",{},"out.jpg"]]}' "acme-jp-001" 60

• 本组 args 须双层数组，见 §0。
• 内置纯 JVM 编码器（SOF2）

94. imageproc.png_adam7 — 隔行 PNG

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"png_adam7","args":[["a.png",{},"out.png"]]}' "acme-pa-001" 60

• 本组 args 须双层数组，见 §0。
• 内置纯 JVM 编码器，无损

95. imageproc.round_pic — 圆角图片

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"round_pic","args":[["in.jpg",24,"out.png"]]}' "acme-rp-001" 60

• 本组 args 须双层数组，见 §0。
• 强制 PNG（JPEG 无 Alpha）

96. imageproc.stitch — 全景拼接

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"stitch","args":[[["a.jpg","b.jpg"],"1600x1200","out.jpg"]]}' "acme-st-001" 180

• 本组 args 须双层数组，见 §0。
• Harris+块描述子+RANSAC 单应性+羽化

97. imageproc.style_apply — 应用样式

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"style_apply","args":[["s1","a.jpg","out.jpg"]]}' "acme-sa-001" 120

• 本组 args 须双层数组，见 §0。
• 复用位图管线（缩放/裁剪/水印/mogr2 等）

98. imageproc.style_delete — 删除样式

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"style_delete","args":[["s1"]]}' "acme-sd-001"

• 本组 args 须双层数组，见 §0。

99. imageproc.style_get — 读取样式

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"style_get","args":[["s1"]]}' "acme-sg-001"

• 本组 args 须双层数组，见 §0。

100. imageproc.style_list — 样式列表

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"style_list","args":[[]]}' "acme-sl2-001"

• 本组 args 须双层数组，见 §0。
• 忽略传入参数

101. imageproc.style_save — 保存样式

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"style_save","args":[["s1",[{"op":"resize","w":800}]]]}' "acme-ss-001"

• 本组 args 须双层数组，见 §0。
• 持久化到 files/image_styles.json，重启保留

102. imageproc.super_resolution — 图片超分

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"super_resolution","args":[["a.jpg",2,"enhanced","out.jpg"]]}' "acme-sr-001" 180

• 本组 args 须双层数组，见 §0。
• aiModel 恒 false（高质量重采样非 GAN）；scale 非 2/3 直接报错

103. imageproc.watermark — 图片水印

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"imageproc","func":"watermark","args":[["a.jpg",{"mode":"single","text":"Hi"},"out.jpg"]]}' "acme-wm2-001" 60

• 本组 args 须双层数组，见 §0。
• mode: single 文本|image 图片|tile 网格|mixed 混合

104. filehw.capabilities — 文件能力探测

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"capabilities","args":[[]]}' "acme-fc-001"

• 本组 args 须双层数组，见 §0。
• zipAes 恒 false，不要把 password 当 AES

105. filehw.concat — 文件拼接

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"concat","args":[[["a.bin","b.bin"],"out.bin",{}]]}' "acme-fcc-001" 300

• 本组 args 须双层数组，见 §0。
• 默认 rejectMedia=true 拒绝音视频图片；流式拼接不加载到内存

106. filehw.md2html — Markdown 转 HTML

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"md2html","args":[["a.md","","{}"]]}' "acme-md-001" 60

• 本组 args 须双层数组，见 §0。
• destPath 为空返回内联 html，预览场景用此模式

107. filehw.html2md — HTML 转 Markdown

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"html2md","args":[["a.html","","{}"]]}' "acme-hm-001" 60

• 本组 args 须双层数组，见 §0。

108. filehw.mkzip — 打包 ZIP

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"mkzip","args":[[["a.txt"],"out.zip",{"level":6}]]}' "acme-mz-001" 600

• 本组 args 须双层数组，见 §0。
• 仅 ZipCrypto（非 AES-256）

109. filehw.probe — 文件探测

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"probe","args":[["a.apk"]]}' "acme-fp-001"

• 本组 args 须双层数组，见 §0。

110. filehw.probe_all — 批量文件探测

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"probe_all","args":[[["a.apk","b.png"]]]}' "acme-fpa-001" 60

• 本组 args 须双层数组，见 §0。
• 空数组直接返回错误

111. filehw.qhash — 文件哈希

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"qhash","args":[["/sdcard/a.apk","sha256"]]}' "acme-qh-001"

• 本组 args 须双层数组，见 §0。
• sha512 在 crypto 模块，不在此处

112. filehw.qhash_all — 全量文件哈希

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"qhash_all","args":[["/sdcard/a.apk"]]}' "acme-qha-001"

• 本组 args 须双层数组，见 §0。
• 一次流式全算，比调两次 qhash 更省

113. filehw.qrcode — 生成二维码

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"filehw","func":"qrcode","args":[["https://xiaohetx.cn","/sdcard/qr.png",{"ecl":"Q"}]]}' "acme-qr-001"

• 本组 args 须双层数组，见 §0。
• content 原样传入不做路径解析

114. spritehw.sprite — 视频雪碧图

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"spritehw","func":"sprite","args":[["in.mp4",{"lines":4,"columns":8,"cellSize":160,"interval":5}]]}' "acme-sp-001" 600

• 本组 args 须双层数组，见 §0。
• spec 可传对象或 JSON 串；interval 与 frames 互斥

115. spritehw.vsample_sprite — 视频采样雪碧图

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"spritehw","func":"vsample_sprite","args":[["in.mp4",{"lines":2,"columns":4}]]}' "acme-vsp-001" 600

• 本组 args 须双层数组，见 §0。
• DORA 命令名别名，与 sprite 同一实现

116. spritehw.sprite_info — 雪碧图规划

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"spritehw","func":"sprite_info","args":[["in.mp4"]]}' "acme-si-001" 60

• 本组 args 须双层数组，见 §0。
• 用于事前规划行列/格尺寸

117. spritehw.capabilities — 雪碧图能力探测

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"spritehw","func":"capabilities","args":[[]]}' "acme-sc-001"

• 本组 args 须双层数组，见 §0。

118. provider.capabilities — 供应商能力

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"provider","func":"capabilities","args":[[]]}' "acme-pc-001"

• 本组 args 须双层数组，见 §0。
• JS 层永不抛异常，全部转 error

119. provider.local_validate — 本地证件校验

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"provider","func":"local_validate","args":[["id_card",{"idNumber":"11010119900307461X","name":"张三"}]]}' "acme-lv-001"

• 本组 args 须双层数组，见 §0。
• 纯本地校验，无网络无供应商

120. provider.verify_identity — 身份核验

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"provider","func":"verify_identity","args":[["default","idcard2",{"realname":"张三","idcard":"11010119900307461X"}]]}' "acme-vi-001" 60

• 本组 args 须双层数组，见 §0。
• 需已配置供应商，幂等 5 分钟

121. provider.audit_probe — 审核探针

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"provider","func":"audit_probe","args":[["qiniu-censor"]]}' "acme-apb-001"

• 本组 args 须双层数组，见 §0。

122. provider.audit_list — 审核厂商列表

• 请求头需带有效的 X-Admin-Key
• 输入文件需已在端上，用 file.download 取得

post_task script '{"module":"provider","func":"audit_list","args":[[]]}' "acme-al-001"