概览
欢迎使用无限识别开发接口。本文档提供了完整的 API 调用说明、参数定义与多语言代码示例， 所有接口通过 secret（API Key）认证，帮助你快速完成业务接入。
常规识别接口
调用深度学习模型进行图像/文本识别。支持多种验证码类型，根据模型不同返回文本、坐标等结果。
接口地址
POST
https://hypercalc.cn/api/pub/model/predict请求参数
Content-Type: application/json
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secret | string | 是 | 用户 API Key |
modelCode | integer | 是 | 模型编码（如 1000） |
imageBase64 | string | 因模型而异 | 图片 Base64 编码（图像类模型必填） |
代码示例
import requests
import base64
url = "https://hypercalc.cn/api/pub/model/predict"
with open("captcha.png", "rb") as f:
img_base64 = base64.b64encode(f.read()).decode()
resp = requests.post(url, json={
"secret": "your_api_key",
"modelCode": 1000,
"imageBase64": img_base64
})
data = resp.json()
print(data["data"]["recordId"]) # 预测记录ID
print(data["data"]["result"]) # 识别结果响应示例
成功（code: 2000）
| 字段 | 类型 | 说明 |
|---|---|---|
data.recordId | string | 预测记录 ID（Snowflake），可用于错误反馈 |
data.result | any | 识别结果，具体格式因模型而异（文本、坐标等） |
失败（code: 5001）
提示信息
secret可在「账户中心」获取，请妥善保管，切勿泄露。modelCode可在模型列表页查看，不同模型对应不同的编码。- 图像类模型必须传入
imageBase64，无需包含data:image/...前缀。 - 响应中的
recordId用于后续「反馈识别错误」接口，请在业务中保存此值。 - 建议通过 HTTPS 访问接口以确保数据安全。
查询余额接口
通过 API Key 查询用户的永久余额和临时余额包信息。
接口地址
GET
https://hypercalc.cn/api/pub/user/balance 也可直接在地址后拼接查询参数，将 your_api_key 换成你的 API Key：
https://hypercalc.cn/api/pub/user/balance?secret=your_api_key请求参数
Query Parameters（与上式 ?secret= 后的值一致）：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secret | string | 是 | 用户 API Key |
代码示例
import requests
url = "https://hypercalc.cn/api/pub/user/balance"
resp = requests.get(url, params={"secret": "your_api_key"})
data = resp.json()
print("永久余额:", data["data"]["permanentBalance"])
for pack in data["data"]["timeLimitedBalances"]:
print(f" {pack['packName']}: {pack['balance']} (过期: {pack['expireTime']}")响应示例
成功（code: 2000）
| 字段 | 类型 | 说明 |
|---|---|---|
data.permanentBalance | string | 永久余额（整数积分） |
data.timeLimitedBalances | array | 临时余额包列表（按过期时间升序） |
data.timeLimitedBalances[].id | string | 余额包 ID |
data.timeLimitedBalances[].packName | string | 商品名称 |
data.timeLimitedBalances[].balance | string | 当前余额（整数积分） |
data.timeLimitedBalances[].expireTime | string | 过期时间（ISO 8601） |
提示信息
- 此接口为 GET 请求，
secret通过 URL 查询参数传递。 - 返回的余额包列表仅包含未过期的有效包，按过期时间升序排列。
- 建议定期查询余额以监控使用量，及时充值避免服务中断。
反馈识别错误接口
当识别结果不正确时，可通过此接口反馈错误。系统将标记该记录为失败，并根据策略决定是否返还已扣积分。
接口地址
POST
https://hypercalc.cn/api/pub/model/predict-feedback请求参数
Content-Type: application/json
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
secret | string | 是 | 用户 API Key |
recordId | number | 是 | 预测记录 ID（从识别接口响应获取） |
业务规则
1
幂等性
对已标记为失败的记录重复调用，直接返回「无需重复反馈」，不影响配额。
2
积分返还路径
永久余额扣费 → 返还到永久余额；临时余额包扣费 → 返还到原余额包。
代码示例
import requests
url = "https://hypercalc.cn/api/pub/model/predict-feedback"
resp = requests.post(url, json={
"secret": "your_api_key",
"recordId": 1912345678901234567
})
print(resp.json()["msg"])响应示例
反馈成功
记录已是失败状态
提示信息
recordId从识别接口响应的data.recordId获取，请在调用识别后妥善保存。- 免费模型的识别不涉及扣费，反馈仅标记状态，不涉及积分返还。
- 请合理使用反馈功能，恶意反馈可能触发风控限制。