实用工具 · 同步接口

二维码生成API接入指南

二维码生成API把网址、链接或任意文本转成二维码图片，支持在码中间叠加自定义Logo图标，并可指定二维码与Logo尺寸，返回可直接保存的PNG Base64数据。单次仅约0.005元，是收银台、活动物料、产品溯源等批量生码场景的低成本方案。

2026年8月20日更新 · 参数与计费已按当前生产接口核对

在线调试接口免费在线工具

接口速览

以下信息来自轻语API开放平台生产环境接口元数据，可直接用于技术选型评估。

接口地址	POST /data/api/fetchQRCodeData
计费	约0.005元/次
频率限制	100次/分钟
超时时间	30秒
鉴权方式	apikey（注册后获取）
内容类型	application/json

请求参数

参数名	必填	类型	说明
`apikey`	必填	`string`	用户的apikey，身份凭证
`text`	必填	`string`	用于生成二维码的内容，可以传网址、链接、文字
`logoUrl`	选填	`string`	二维码中间的logo小图标URL；加logo后生成速度会略微降低
`size`	选填	`int`	指定二维码的尺寸（像素）
`logoSize`	选填	`int`	指定logo的尺寸；建议小于size的八分之一，过大会导致二维码无法识别

响应示例

成功响应（HTTP 200）

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "code": 1,
    "qrcode": "iVBORw0KGgoAAAANSUhEUgAAAP8..."  // PNG图片的Base64字符串
  }
}

调用示例

cURL 示例

curl -X POST 'https://5555api.com/data/api/fetchQRCodeData' \
  -H 'Content-Type: application/json' \
  -d '{"apikey":"YOUR_APIKEY","text":"https://5555api.com","size":300}'

JavaScript 示例

const resp = await fetch('https://5555api.com/data/api/fetchQRCodeData', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'YOUR_APIKEY',
    text: 'https://5555api.com',
    size: 300,                       // 可选：二维码尺寸
    logoUrl: 'https://example.com/logo.png',  // 可选：中间logo
    logoSize: 36                     // 可选：建议 < size/8
  })
});
const result = await resp.json();
if (result.code === 200) {
  const img = document.createElement('img');
  img.src = 'data:image/png;base64,' + result.data.qrcode;
  document.body.appendChild(img);   // 前端直接展示
}

Python 示例

import requests, base64

resp = requests.post(
    'https://5555api.com/data/api/fetchQRCodeData',
    json={
        'apikey': 'YOUR_APIKEY',
        'text': 'https://5555api.com',
        'size': 300
    }
)
result = resp.json()
if result['code'] == 200:
    png = base64.b64decode(result['data']['qrcode'])
    open('qrcode.png', 'wb').write(png)  # 保存为本地PNG文件
    print('已保存 qrcode.png')

示例中的 YOUR_APIKEY 请替换为你在轻语API控制台获取的apikey；不要在公开页面或客户端代码中暴露正式API Key。

应用场景

收银与支付码牌

门店收款链接批量生成收款二维码，叠加品牌Logo后打印成桌牌与立牌。

活动与物料印刷

邀请链接、活动页、电子票务批量生码，尺寸可按印刷要求精确控制。

产品溯源与防伪

每个产品序列号生成唯一二维码，扫码直达溯源页面，Base64结果直存图片服务。

常见问题

二维码生成API怎么调用？

POST https://5555api.com/data/api/fetchQRCodeData，JSON传apikey和text（网址或文本）即可，返回PNG图片的Base64字符串。单次约0.005元。

怎么在二维码中间加Logo？

传logoUrl参数（Logo图片的网络地址），可选logoSize控制大小。注意logoSize建议小于size的八分之一，否则可能导致二维码无法扫描。

返回的Base64怎么用？

前端拼接 data:image/png;base64, 前缀即可直接用img标签展示；后端用Base64解码后保存为.png文件。

二维码尺寸怎么指定？

size参数指定二维码像素尺寸（如300）。印刷场景建议生成较大尺寸再等比缩放，保证清晰度。

能生成多少个二维码，有批量限制吗？

接口单次生成一个二维码，频率限制100次/分钟。几千个以内的批量生码可以循环调用完成，量级更大建议控制并发或错峰执行。

二维码内容可以是中文吗？

可以。网址、链接、中文文本均支持。内容越长二维码越密，建议对长文本先做短链处理再生成。