接口文档--财务票据识别-火山引擎

文档中心

导航

接口文档

最近更新时间：2021.12.16 13:58:38首次发布时间：2021.12.16 13:58:38

接入指引

请先查看接入指引了解具体接入方式，再参考此文档完成接入。

请求API

名称	内容
请求方式	POST
Content-Type	application/x-www-form-urlencoded (传入参数不包含类型File)
是否需要鉴权	是
图片要求	1. 图片格式：JPG、JPEG、PNG、BMP等常见格式，建议使用JPG格式。 2. 图片像素尺寸：为了保证文字识别效果，推荐图片中火车票最短边长不低于256像素。 3. 图片文件大小：最大 4 MB。火车票主体尽量占据图片主要区域。 4. 注意图片质量：保证火车票图片足够清晰，不应该有因为压缩导致的噪声，避免对火车票正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。 5. 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。 6.火车票图片不可以是复印件、翻拍件、PS件等。

输入参数

Query参数：

参数	可选/必选	类型	说明
Action	必选	String	接口名，取值：OcrTrainTicket
Version	必选	String	版本号，取值：2020-08-26

Body参数：

参数	可选/必选	类型	说明
image_base64	必选	String	驾驶证图片文件，base64编码

API返回

通用返回字段说明

请参考通用返回字段及错误码

data 字段说明

字段	类型	说明	备注
ticket_main	main_info	主页面信息	字段说明见下方

main_info 字段说明

字段	类型	说明	备注
ticket_num	String	票号	主页信息
start_station	String	出发站	主页信息
train_num	String	车次	主页信息
end_station	String	到达站	主页信息
time	String	出发时间	主页信息
seat_num	String	座位号	主页信息
price	String	价格	主页信息
seat_cls	String	座位等级	主页信息
id_num	String	证件号	主页信息
name	String	姓名	主页信息
sale_num	String	销售编号	主页信息
sale_station	String	售票车站	主页信息
sub_type	String	车票类型(正常票，补票等其他票)	主页信息

错误码

HttpCode	错误码	错误消息	描述
200	10000	"Success"	请求成功
400	50204	"Parse Request Parameters Error"	缺少参数
401	50205	"Image Size Exceeds Maximum Limit: please compress the image"	图片大小超过上限
400	50207	"Image Decode Error: image format unsupported"	图片解码错误，文件内容为空或格式错误
400	50208	"Invalid Input Image: No object detected in input image, bad input image"	输入图片没有检测到火车票
401	50400	见下方鉴权错误信息	鉴权失败
404	50402	"Request URL Error"	无效的请求路径
500	50500	"Internal Error: please contact with bytedance engineering team"	内部错误，需要联系开发人员

返回值示例

主页面图片返回值示例

{
   "code":10000,
   "data":{
      "ticket_main":{
         "ticket_num":"Q099454",
         "start_station":"南京南",
         "train_num":"G124",
         "end_station":"北京南",
         "time":"2015年07月10日12:21开",
         "seat_num":"11车13A号",
         "price":"¥443.5元",
         "seat_cls":"二等座",
         "id_num":"341126********4921",
         "name":"王XX",
         "sale_num":"10010000490718Q099454",
         "sale_station":"北京南售",
         "sub_type":"normal_ticket"
      }
   },
   "message":"Success",
   "request_id":"68981614972690780231606103381",
   "status":10000,
   "time_elapsed":"387.625781ms"
}