AiQR 开放 API

用 HTTP 接口程序化地「创建隐写图」与「识别隐写图」。Base URL:https://aiqr.miaomiao.help

1. 创建隐写图 · POST /api/v1/encode

把文字/网址藏进一张图。multipart/form-data

默认返回 image/png(响应头含 X-Grid);加 ?format=json 返回含 base64 的 JSON。

# 纯文本 -> 下载隐写图
curl -X POST https://aiqr.miaomiao.help/api/v1/encode \
     -F "message=https://aiqr.miaomiao.help" \
     -o stego.png

# 指定底图,返回 JSON(含 base64)
curl -X POST "https://aiqr.miaomiao.help/api/v1/encode?format=json" \
     -F "message=hello world" \
     -F "image=@my_photo.jpg"

2. 识别隐写图 · POST /api/v1/decode

上传隐写图(生成的 PNG 或拍摄的照片),解出内容。multipart/form-data,字段 image。

curl -X POST https://aiqr.miaomiao.help/api/v1/decode \
     -F "image=@stego.png"

# 成功
{"ok": true, "text": "https://aiqr.miaomiao.help", "ref": false, "grid": 3, "blocks": 9}
# 失败(HTTP 422)
{"ok": false, "error": "未能解出完整内容...", "got": 6, "need": 8}

3. 能力查询 · GET /api/v1/health

curl https://aiqr.miaomiao.help/api/v1/health
{"ok": true, "grids": [2,3,4,5,6], "caps_bytes": {...}, "max_bytes": ...}

说明

• 内容 ≤ 自包含容量时,数据完全藏在图里、离线可解;超长内容自动改为服务端 @token 引用。
• 私有编码:仅本平台可解,通用扫码 App 读不出。
• 识别用的是清晰生成图时一次即可解;拍照场景建议正对、拍全、光照均匀。