快速接入 CodeMark

1. 准备账号与密钥

1. 打开 控制台登录，使用管理员下发的账号。
2. 进入「API 密钥」→「创建密钥」，复制完整密钥（可随时回看）。
3. 在「账户信息」确认余额；不足时联系管理员充值。

2. 识别接口

POST /api/v1/recognize

请求头：

Content-Type: application/json
X-API-Key: <你的密钥>

请求体：

{
  "type": "click99_full",
  "referer": "https://nshop.99.com/payGame/GameDirectCharge?..."
}

99 点选协议（click99_full）无需传图，服务端拉 getcode+识别，返回 verifyCodeId|坐标。

G买卖拼图滑块协议（gmm_slide）无需传图，传手机号即可；服务端拉码+过验，返回 sessionKey|checkCodeGuid|point|deviceId：

{
  "type": "gmm_slide",
  "id": "13800138000"
}

可选 challenge 固定 device_id。

极验 v3 语序点选协议（gt_full，猫耳 FM 密码登录等）无需传图，服务端拉码+过验，返回 challenge|validate：

{
  "type": "gt_full"
}

畅游图码（cy_imagecode）传 auth.changyou.com/servlet/ImageCode 的图片（ddddocr 识别）：

{
  "type": "cy_imagecode",
  "image": "<图码 base64>"
}

网易易盾完整验证（yidun_full）传 captcha id + referer，返回可直接用于 URS 的 validate：

{
  "type": "yidun_full",
  "id": "f52078b85cd441dc860492247dfebbcc",
  "referer": "https://dl.reg.163.com/webzj/v1.0.1/pub/index2_new.html",
  "fp_host": "ecard.163.com"
}

Geetest v4 图标点选（gt4_icon）传极验 captcha_id，无需图片；result 为 JSON 字符串（含 lot_number、pass_token、captcha_output、gen_time）。服务端纯 Rust，需 models/gt4_icon/best.onnx 与 ONNX Runtime（见 config.toml 的 ocr_ort_dylib）：

{
  "type": "gt4_icon",
  "id": "你的极验_captcha_id",
  "referer": "https://你的业务页/"
}

Geetest v4 九宫格（gt4_nine）同样无需传图：服务端带 risk_type=nine 拉题、下载 3×3 底图与提示图、融合选格，并生成 v1.9.7 patrol 参数与拟人点击轨迹 td 后提交验证。id 省略时使用极验官方 demo 的 captcha_id：

{
  "type": "gt4_nine",
  "id": "54088bb07d2df3c46b79f80300b0abbe",
  "referer": "https://gt4.geetest.com/demov4/nine-popup-zh.html"
}

result 为 validate JSON 字符串：{"captcha_id":"…","lot_number":"…","pass_token":"…","gen_time":"…","captcha_output":"…"}，业务侧用 lot_number + captcha_output + pass_token 去极验后台二次校验。选格模型放在 models/gt4_nine/：nine.onnx（端到端分类器）、vision_backbone.onnx + match_head.onnx（孪生匹配）、nine_embed.onnx（嵌入余弦）；缺哪个后端就自动跳过，全缺时回退纯 NCC。

成功响应示例：

{
  "task_id": "tk_...",
  "result": "95:74,191:69,156:116",
  "cost": 10,
  "latency_ms": 541
}

• result：点选为 x:y 坐标串；畅游图码为字母数字（如 a3K9）；滑块为缺口 X（如 113）；yidun_full 为 CN31_…_v_i_1；gt4_icon 为 validate 对象 JSON。
• cost：本次扣点。
• latency_ms：服务端耗时。

3. curl 示例

curl -s -X POST http://127.0.0.1:3000/api/v1/recognize \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"type":"click99_full","referer":"https://nshop.99.com/payGame/GameDirectCharge?gameType=104&areaID=1&serverID=1&buyType=11"}'

4. 常见问题