运行中

免费额度

文档识别

二维码识别

API

上传含二维码或条形码的图片（URL 或 base64），自动识别并返回解码文本、码类型和四角位置。支持一图多码。适用于扫码核销、仓储入库、海报解析、条码录入等场景。需要登录后使用，匿名不可调用。

接入文档接入 MCP

由极数本源提供·更新于 3 天前

先试用，再接接口

不用写代码。打开工具页跑一遍二维码识别，看清结果再来订阅。

打开二维码识别

累计调用

93ms

平均响应

100.00%

服务可用性

10 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 2

今日已用 … / 10 次/日…

已登录并携带 API Key 时，可使用上方免费额度。各会员档额度见下方。

未携带 API Key

无

已登录（未开通会员）

每天 10 次 · QPS 2

免费试用

一次性 5 次

黄金会员

每天 100 次 · QPS 10

钻石会员

每天 5,000 次 · QPS 30

企业会员

每天不限次 · QPS 60

AI 文档

把这个地址发给 AI，就能生成调用代码

https://apizero.cn/aidocs/ocr-qrcode/raw.md

打开文档

接入文档

打开

接口请求地址

https://v1.apizero.cn/api/ocr-qrcode

接口请求方式

POST

请求参数格式

APPLICATION/JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/ocr-qrcode

接口信息备注

未携带 API Key：无；已登录（未开通会员）：每天 10 次 · QPS 2；试用：一次性 5 次；黄金会员：每天 100 次 · QPS 10；钻石会员：每天 5,000 次 · QPS 30；企业会员：每天不限次 · QPS 60；点数：本接口不支持扣点；免费。需要 API Key（Authorization: Bearer <key>）。也可直接传 url 或 image（base64），与 input_type + input_data 等价。

请求参数说明

input_typestring

必填 · 图片传入方式：url 或 base64。也可省略本字段，改传 url / image · 默认 url · 示例：url

input_datastring

必填 · 图片 URL 或 base64（jpg/png，可带 data:image 前缀，最大 10 MB）。兼容别名 url、image · 示例：https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=https%3A%2F%2Fwww.apizero.cn

名称	类型	说明
input_type	string	必填 · 图片传入方式：url 或 base64。也可省略本字段，改传 url / image · 默认 url · 示例：url
input_data	string	必填 · 图片 URL 或 base64（jpg/png，可带 data:image 前缀，最大 10 MB）。兼容别名 url、image · 示例：https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=https%3A%2F%2Fwww.apizero.cn

请求头说明

Authorizationstring

可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

Content-Typestring

必填 · 请求体格式

名称	类型	说明
Authorization	string	可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
Content-Type	string	必填 · 请求体格式

返回字段说明

countnumber

识别到的码数量（一图可多码）

itemsarray

识别结果列表

textstring

解码文本

typestring

码类型，常见 qrcode、barcode

positionobject

四角像素坐标

left_top.xnumber

左上角 x

left_top.ynumber

左上角 y

right_top.xnumber

右上角 x

right_top.ynumber

右上角 y

right_bottom.xnumber

右下角 x

right_bottom.ynumber

右下角 y

left_bottom.xnumber

左下角 x

left_bottom.ynumber

左下角 y

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

名称

类型

说明

count

number

识别到的码数量（一图可多码）

items

array

识别结果列表

text

string

解码文本

type

string

码类型，常见 qrcode、barcode

position

object

四角像素坐标

left_top.x	number	左上角 x
left_top.y	number	左上角 y
right_top.x	number	右上角 x
right_top.y	number	右上角 y
right_bottom.x	number	右下角 x
right_bottom.y	number	右下角 y
left_bottom.x	number	左下角 x
left_bottom.y	number	左下角 y

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "count": 1,
    "items": [
      {
        "text": "https://www.apizero.cn/",
        "type": "qrcode",
        "position": {
          "left_top": {
            "x": 40.5,
            "y": 40.5
          },
          "right_top": {
            "x": 410.5,
            "y": 40.5
          },
          "right_bottom": {
            "x": 410.5,
            "y": 410.5
          },
          "left_bottom": {
            "x": 40.5,
            "y": 410.5
          }
        }
      }
    ]
  },
  "request_id": "req_abc123",
  "tips": "极数本源 · https://apizero.cn"
}

免责声明

识别结果以图片清晰度为准；模糊、残缺、反光过强可能导致漏识。请勿用于违法用途。

加载接口文档…

名称

类型

说明

input_type

string

必填 · 图片传入方式：url 或 base64。也可省略本字段，改传 url / image · 默认 url · 示例：url

input_data

string

名称

类型

说明

Authorization

string

Content-Type

string

必填 · 请求体格式

{ "code": 0, "msg": "成功", "data": { "count": 1, "items": [ { "text": "https://www.apizero.cn/", "type": "qrcode", "position": { "left_top": { "x": 40.5, "y": 40.5 }, "right_top": { "x": 410.5, "y": 40.5 }, "right_bottom": { "x": 410.5, "y": 410.5 }, "left_bottom": { "x": 40.5, "y": 410.5 } } } ] }, "request_id": "req_abc123", "tips": "极数本源 · https://apizero.cn" }