跳转到主要内容
POST
/
ai
/
service
/
v1
/
bill_recognize_v2
国内通用票据v2接口识别
curl --request POST \
  --url https://api.textin.com/ai/service/v1/bill_recognize_v2 \
  --header 'Content-Type: application/octet-stream' \
  --header 'x-ti-app-id: <api-key>' \
  --header 'x-ti-secret-code: <api-key>' \
  --data '"success"'
{
  "code": 200,
  "message": "success",
  "pageNum": 1,
  "pages": [
    {
      "result": {
        "object_list": [
          {
            "type": "other",
            "type_description": "增值税普通发票",
            "image_angle": 0,
            "rotated_image_width": 1000,
            "rotated_image_height": 3000,
            "kind": "other",
            "kind_description": "交通",
            "position": [
              100,
              100,
              200,
              100,
              200,
              200,
              100,
              200
            ],
            "stamp_list": [
              [
                {
                  "key": "stamp_type",
                  "value": "全国统一发票监制章",
                  "description": "印章类型",
                  "position": [
                    100,
                    100,
                    200,
                    100,
                    200,
                    200,
                    100,
                    200
                  ]
                }
              ]
            ],
            "qr_code_list": [
              [
                {
                  "key": "qr_code_info",
                  "value": "01,61,,24118999111000010898,770.00,20240412,,0134",
                  "description": "二维码内容",
                  "position": [
                    100,
                    100,
                    200,
                    100,
                    200,
                    200,
                    100,
                    200
                  ]
                }
              ]
            ],
            "item_list": [
              {
                "key": "title",
                "value": "True",
                "position": [
                  100,
                  100,
                  200,
                  100,
                  200,
                  200,
                  100,
                  200
                ],
                "description": "标题"
              }
            ]
          }
        ]
      },
      "page_number": 0,
      "duration": 7700,
      "ppi": 0
    }
  ]
}

授权

​
x-ti-app-id
string
header
必填

请登录Textin后前往 "工作台-账号设置-开发者信息" 查看 x-ti-app-id

​
x-ti-secret-code
string
header
必填

请登录Textin后前往 "工作台-账号设置-开发者信息" 查看 x-ti-secret-code

查询参数

​
coord_restore
enum<integer>
默认值:0

调整各字段的返回坐标逻辑，1代表坐标以原图为基准，0代表坐标以票据切图为基准，默认为0

可用选项:
0,
1
​
specific_pages
string

指定多页样本中需要识别的样本，可以使用"1,3,2"形式来逐页选择，或"2-4"形式来连续选择，返回结果会重新排序以遵照源文件顺序，默认为空，识别所有页面

示例:

"3-5,1"

​
crop_complete_image
enum<integer>
默认值:0

选择是否需要输出各票据图片，1为输出各票据切片base64编码，0为不输出各票据图片，默认为0

可用选项:
0,
1
​
crop_value_image
enum<integer>
默认值:0

选择是否返回关键字段切图图片，1为输出字段图片，0为不输出字段图片，默认为0

可用选项:
0,
1
​
merge_digital_elec_invoice
enum<integer>
默认值:0

支持将多页全电票的结果合并为一页，1为合并，0为不合并，默认为0 当且仅当一份多页样本的每一页都是全电票，且每张发票的发票号码都一致时才可合并。

可用选项:
0,
1
​
return_ppi
enum<integer>
默认值:0

返回pdf解码ppi

可用选项:
0,
1

请求体

application/octet-stream

支持以下两种请求格式

  1. Content-Type: application/octet-stream 要上传的图片，目前支持jpg、png、bmp、pdf、tiff、ofd、单帧gif等大部分格式，pdf和ofd文件支持多页​请注意，请求体的数据格式为本地文件的二进制流，非 FormData 或其他格式。文件大小不超过 50M，图像宽高须介于 20 和 10000（像素）之间。

  2. Content-Type: text/plain 请求体的数据格式为文本，内容为在线文件的URL链接（支持http以及https协议）。在线文件大小不超过 50M，图像宽高须介于 20 和 10000（像素）之间。

The body is of type file.

示例:

"success"

响应

200 - application/json
​
code
enum<integer>
必填

错误码

  • 200: success
  • 40101: x-ti-app-id 或 x-ti-secret-code 为空
  • 40102: x-ti-app-id 或 x-ti-secret-code 无效，验证失败
  • 40003: 余额不足，请充值后再使用
  • 40004: 参数错误，请查看技术文档，检查传参
  • 40007: 机器人不存在或未发布
  • 40008: 机器人未开通，请至市场开通后重试
  • 40301: 文件类型不支持，接口会返回实际检测到的文件类型，如“当前文件类型为.gif”
  • 40302: 上传文件大小不符，文件大小不超过 50M
  • 40303: 文件类型不支持
  • 40304: 图片尺寸不符，图像宽高须介于 20 和 10000（像素）之间
  • 40305: 识别文件未上传
  • 40306: QPS超过限制，收到此状态码时请勿重试，持续请求可能触发IP流控，如需扩容请联系商务
  • 40400: 无效的请求链接，请检查链接是否正确
  • 30203: 基础服务故障，请稍后重试
  • 500: 服务器内部错误
可用选项:
200,
40101,
40102,
40003,
40004,
40007,
40008,
40301,
40302,
40303,
40304,
40305,
40306,
40400,
30203,
500
示例:

200

​
message
string
必填

成功或错误信息

示例:

"success"

​
pageNum
integer

总页数

示例:

1

​
pages
object[]

样本每页的识别结果