API 概览 | FreeAIOCR

使用 FreeAIOCR API 识别图片中的文字或提取表格。上方两个接口参考入口分别说明各自的输入、输出格式和特有规则。

快速开始

完成账户邮箱验证
在 API 密钥设置页创建密钥，密钥仅展示一次，请立即妥善保存
向 API 余额充值 $5。同一账户的密钥共享余额，余额与网站订阅独立，且不会过期
在服务端运行下方请求示例，将 YOUR_API_KEY 和 document.png 替换为自己的密钥和图片
查看识别结果、token 用量和计费字段

身份认证

Authorization: Bearer YOUR_API_KEY

通过 HTTPS 使用 Bearer 认证，并将密钥保存在服务端；不支持浏览器跨域 API 调用，切勿把密钥写入公开代码。

发送首次请求

使用 POST、Bearer 密钥和 image 字段上传且仅上传一张图片。替换下方的 YOUR_API_KEY 和 document.png 文件路径，让 cURL 自动设置 multipart Content-Type 及边界。仅接受可选的 format 查询参数，不接受额外表单字段或模型设置。请从服务端调用，不支持浏览器跨域调用，不要公开密钥。

curl --silent --show-error --include --max-time 150 \
  'https://freeaiocr.com/api/v1/image-to-text' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: example-request-0001' \
  -F 'image=@document.png'

查看响应

下方 JSON 是示例，实际识别文字和 token 用量取决于图片。

{
  "request_id": "b2c8ec98-2a36-4f87-99d2-3d7839b92518",
  "text": "# Document title\n\nRecognized paragraph.\n\n| Item | Count |\n| --- | --- |\n| Books | 12 |",
  "usage": {
    "input_tokens": 2000,
    "output_tokens": 4000
  },
  "billing": {
    "currency": "USD",
    "price_version": "2026-10-26-v1",
    "base_usd": "0.002000000",
    "input_overage_usd": "0.000000000",
    "output_overage_usd": "0.002400000",
    "total_usd": "0.004400000"
  }
}

安全重试

网络异常时，使用相同的 Idempotency-Key 和原始图片重试。新的业务操作需要新的唯一编号；若原请求结果或计费尚不确定，不要另建操作。详见重试策略。

这些公共指南适用于图片转文字和图片转表格。各接口支持的输入、格式和特有错误，请查看对应接口参考。

选择接口

快速开始

身份认证

发送首次请求

查看响应

安全重试