智能多媒体服务

    • 智能多媒体服务 > API 文档 > 票证自动识别（OCR） >增值税发票 OCR

    增值税发票 OCR

    最近更新时间: 2026-08-18 15:20:11

    接口说明

    增值税发票文字识别，结构化输出增值税发票上的字段文字信息。

    限制条件

    1. 文件格式：支持JPG、JPEG、PNG、BMP、PDF、OFD等常见格式，建议使用JPG格式。
    2. 图片像素尺寸：最小 256 x 256 像素，最大 2048 x 2048 像素。为了保证文字识别效果，推荐图片中增值税发票最短边长不低于256像素。
    3. 文件大小：
      a.要求Base64编码和urlencode之后不超过 8 MB。增值税发票主体尽量占据图片主要区域，不支持黑白图片。
      b.如果传图片及PDF完整URL，URL对应文件大小建议不要超过8MB。
    4. 输入文件过大时，返回的HttpCode如下：400/413/502。
    5. 注意图片质量：保证增值税发票图片足够清晰，不应该有因为压缩导致的噪声，避免对增值税发票正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。
    6. 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。
    7. 增值税发票图片不可以是复印件、翻拍件、PS件等。
    8. 输入多页PDF时，默认只识别第一页。

    请求

    请求地址

    名称值
    HTTP URLhttps://ap-gate-z0.qiniuapi.com/ocr/vat/invoice
    HTTP MethodPOST

    请求头

    名称必填说明
    Host是固定值ap-gate-z0.qiniuapi.com
    Authorization是该参数应严格按照管理凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于：Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7...
    Content-Type是固定值application/json

    请求参数

    字段必填类型说明
    image_base64否string增值税发票图片文件，base64编码
    image_url否string图片/PDF文件的URL链接
    注意: 要求image_base64与image_url二选一，如果2个字段都有，优先解析image_base64。

    请求示例

    POST /ocr/vat/invoice
Host: ap-gate-z0.qiniuapi.com
Authorization: <no value>
Content-Type: application/json

{
  "image_base64": "base64"
}

    响应

    响应头

    名称必填说明
    Content-Type是固定值application/json

    响应参数

    字段必填类型说明
    message是string错误信息
    request_id是string请求唯一ID
    time_elapsed是string请求耗时
    code是number错误码
    data否object data

    其中，data 参数

    字段必填类型说明
    license_main否object license_main

    其中，license_main 参数

    字段必填类型说明
    payee否string收款人
    seller_taxpayer_no_in_seal否string盖章公司纳税人识别号
    check_code否string校验码
    total_tax否string税额
    invoice_code否string发票代码
    invoice_name否string发票名称
    sheet_name否string发票联次
    big_total_price_and_tax否string大写金额（价税合计）
    drawer否string开票人
    is_secret_out_bound否string密码区是否出界
    seller_account否string销售方开户行&账号
    seller_address_phone否string销售方地址&电话
    seller_name否string销售方
    seller_name_in_seal否string盖章公司名称
    total_price否string金额
    buyer_taxpayer_no否string购买方纳税人识别号
    entry否[]object entry相片位置
    typed_invoice_no否string机打发票号码
    buyer_account否string购买方开户行&账号
    machine_num否string机器编号
    total_price_and_tax否string小写金额（价税合计）
    invoice_no否string发票号码
    invoice_special_seal否string发票专用章
    is_sealed否string是否加盖章
    reviewer否string复核
    seller_taxpayer_no否string销售方识别号
    sub_type否string增值税发票类别
    buyer_address_phone否string购买方地址&电话
    invoice_date否string开票日期
    typed_invoice_code否string机打发票代码
    beizhu否string备注
    buyer_name否string购买方名称

    其中，entry 参数

    字段必填类型说明
    quantity否string数量
    tax_amount否string税额
    tax_rate否string税率
    uint否string单位
    unit_price否string单价(不含税)
    xinghao否string型号
    entry_name否string货物或应税劳务、服务名称
    price_amount否string金额

    sub_type 发票类别字段说明

    字段类型说明
    ele_vatstring增值税电子普通发票
    ele_special_vatstring增值税电子专票
    print_vatstring增值税纸质普票
    special_vatstring增值税纸质专票
    other_vatstring其他电子发票
    quandian_special_vatstring全电专票
    quandian_vatstring全电普票
    unknown_vatstring未知票

    响应示例

    200 OK
Content-Type: application/json

{
  "code": 10000,
  "data": {
    "license_main": {
      "big_total_price_and_tax": "柒拾叁圆玖角贰分",
      "buyer_name": "北京字跳网络技术有限公司",
      "buyer_taxpayer_no": "91110108MA01F2L25J",
      "check_code": "16649652847559064366",
      "drawer": "杜洪亮",
      "entry": [
        {
          "entry_name": "*运输服务*客运服务费",
          "price_amount": "73.92",
          "quantity": "1",
          "tax_amount": "***",
          "tax_rate": "免税",
          "unit": "次",
          "unit_prict": "73.92",
          "xinghao": "无"
        }
      ],
      "invoice_code": "011002000611",
      "invoice_date": "2020年12月14日",
      "invoice_name": "XX增值税电子普通发票",
      "invoice_no": "10178760",
      "invoice_special_seal": "发票专用章",
      "is_sealed": "true",
      "machine_num": "499098491560",
      "payee": "张雪丽",
      "reviewer": "蔡静",
      "seller_account": "招商银行股份有限公司北京东三环支行110936504210806",
      "seller_address_phone": "北京市海淀区东北旺西路8号院34号楼二层208号010-62682929",
      "seller_name": "北京滴滴出行科技有限公司",
      "seller_name_in_seal": "北京滴滴出行科技有限公司",
      "seller_taxpayer_no": "91110108MA01G0FB09",
      "seller_taxpayer_no_in_seal": "91110108MA01G0FB09",
      "sub_type": "ele_vat",
      "total_price": "73.92",
      "total_price_and_tax": "73.92",
      "total_tax": "***"
    }
  },
  "message": "Success",
  "request_id": "6838889517957515275",
  "time_elapsed": "41.897331ms"
}
    以上内容是否对您有帮助？