支持识别飞机行程单关键字段,返回结构化信息。
名称 | 内容 |
---|---|
输入要求 | 1. 文件格式:支持JPG、JPEG、PNG、BMP、PDF等常见格式,建议使用JPG格式。 2. 图片像素尺寸:为了保证文字识别效果,推荐图片中行程单最短边长不低于256像素。 3. 文件大小: a.要求Base64编码和urlencode之后不超过 8 MB。行程单主体尽量占据图片主要区域。 b.如果传图片及PDF完整URL,URL对应文件大小建议不要超过8MB。 4. 输入文件过大时,返回的HttpCode如下:400/413/502。 5. 注意图片质量:保证行程单图片足够清晰,不应该有因为压缩导致的噪声,避免对行程单正反面的遮挡、不当的光照(强光、暗光、逆光)等,否则会降低结果准确度。 6. 图片需要有版权,有肖像权,没有法律或者政策风险的。相关风险请注意评估。 7. 输入多页PDF时,默认只识别第一页。 |
名称 | 内容 |
---|---|
接口地址 | https://visual.volcengineapi.com |
请求方式 | POST |
Content-Type | application/x-www-form-urlencoded (传入参数不包含类型File) |
是否需要鉴权 | 是 |
以下请求参数列表仅列出了接口请求参数和必要公共参数,完整公共参数列表见 公共参数。
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
X-Date | String | 是 | 使用UTC时间,精确到秒。请使用格式:YYYYMMDD'T'HHMMSS'Z' ,例如:20201103T104027Z |
Authorization | String | 是 | HMAC-SHA256:签名方法 |
X-Security-Token | String | 否 | 指安全令牌服务(Security Token Service,STS) 颁发的临时安全凭证中的SessionToken,使用长期密钥时无需填写该参数。 |
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
Action | 必选 | String | 接口名,取值:OcrFlightInvoice |
Version | 必选 | String | 版本号,取值:2020-08-26 |
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
image_base64 | 与image_url二选一 | String | 图片文件,base64编码 注意: 只需要传图片的base64值,类似data:image/png;base64的图片头不要传入 |
image_url | 与image_base64二选一 | String | 图片/PDF文件的URL链接 注意: 要求image_base64与image_url二选一,如果2个字段都有,优先解析image_base64。 |
请参考通用返回字段及错误码 |
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
invoice_main | main_info | 主页面信息 | 字段说明见下方 |
字段 | 类型 | 说明 | 备注 |
---|---|---|---|
title | String | 发票抬头 | 主页信息 |
name | String | 姓名 | 主页信息 |
id_no | String | 身份证号 | 主页信息 |
fare | String | 票价 | 主页信息 |
civil_aviation_development_fund | String | 民航发展基金 | 主页信息 |
fuel_surcharge | String | 燃油附加税 | 主页信息 |
other_taxes | String | 其他税费 | 主页信息 |
total | String | 合计费用 | 主页信息 |
e_ticket_no | String | 电子客票号 | 主页信息 |
ck | String | 验证码 | 主页信息 |
insurance | String | 保险费 | 主页信息 |
date_of_issue | String | 填开日期 | 主页信息 |
agent_code | String | 销售单位代号 | 主页信息 |
issued_by | String | 填开单位 | 主页信息 |
internation | String | 国际 | 主页信息 |
from | String | 起始站 | 主页信息 |
to | String | 终点站 | 主页信息 |
carrier | String | 承运人 | 主页信息 |
flight | String | 航班号 | 主页信息 |
class | String | 座位等级 | 主页信息 |
date | String | 日期 | 主页信息 |
time | String | 时间 | 主页信息 |
fare_basis | String | 客票等级 | 主页信息 |
{ "code":10000, "data":{ "invoice_main":{ "title":"航空运输电子客票行程单", "name":"李XX", "id_no":"640103********0336", "fuel_surcharge":"40.00", "fare":"1130", "civil_aviation_development_fund":"CY50.", "total":"1220.00", "e_ticket_no":"8803****1619", "date_of_issue":"2010-06-14", "agent_code":"WTR****SXY", "issued_by":"苏州快平航空票务服务", "from":"上海浦东", "to":"西安 XIY", "time":"19JUN", "fare_basis":"562" } }, "message":"Success", "request_id":"68985943324423639171606204159", "status":10000, "time_elapsed":"371.220366ms" }
请参考通用返回字段及错误码
HttpCode | 错误码 | 错误消息 | 描述 |
---|---|---|---|
200 | 10000 | "Success" | 请求成功 |
400 | 50204 | "Parse Request Parameters Error" | 缺少参数 |
400 | 50205 | "Image Size Exceeds Maximum Limit: please compress the image" | 输入文件过大 |
400 | 50206 | "Invalid Input Image: image is empty" | 输入图片为空 |
400 | 50207 | "Image Decode Error: image format unsupported" | 图片解码错误 |
400 | 50217 | "Process PDF File Error." | 处理PDF文件错误 |
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" | 内部错误,需要联系开发人员 |