# 描述
智能识别各类通用/非通用卡证、资信证明文件及其他KYC相关文件。
# 调用URL
https://api.yljz.com/finauth/v1/anydoc
注意:在生产环境中,请使用HTTPS的通信方式。HTTP方式的通信属于不安全链路,存在安全风险,请勿在生产环境中使用。在生产环境中使用HTTP方式的,将无法得到服务可靠性保障。
# 调用方法
POST 注意:用form-data格式请求
接口说明
客户传入通过apikey和secret生成的加密签名sign,同时提供待识别的文档,并获取识别结果。
不同文档类型对应不同的app_id,且不同app_id支持的文档格式(pdf/图片)、数量不同(单个或多个),具体参见文档清单。
# 参数
| 必选/可选 |
参数名 |
类型 |
参数说明 |
| 必选 |
sign |
String |
调用此API客户的签名,具体的签名产生方式请查阅鉴权 |
| sign_version |
String |
签名算法版本号,请传递:hmac_sha1 |
| app_id |
String |
每类文档对应一个唯一的app_id,参见可识别文档清单 |
| file |
File或File[] |
需要识别的文档,文档总大小不超过10M,每个app_id支持的文档格式类型(图片或PDF)/数量不同(单个或多个),图片支持:".jpg", ".jpeg", ".png",“gif”,"webp",参见可识别文档清单 |
| 可选 |
file_url |
Array String |
需要识别的文档url,file_url与file二选一,不可同时传入。每个app_id支持的文档格式及数量不同,参见可识别文档清单,示例'[“https ://xxx/8e013.jpeg”,"https ://xxx/8e014.jpeg"]' |
| inputs |
JSON String |
除待识别文档之外的额外参数信息,大部分app_id不支持此参数,参见可识别文档清单,示例‘inputs’:json.dumps({"key1":"value1","key2":"value2"}) |
# 返回值
| 字段 |
类型 |
说明 |
| request_id |
String |
用于区分每一次请求的唯一的字符串。除非发生404(API_NOT_FOUND)或 403 (AUTHORIZATION_ERROR)错误,剩余情况此字段必定返回。 |
| time_used |
Int |
整个请求所花费的时间,单位为毫秒。此字段必定返回。 |
| result |
Object |
文档识别的结果对象,不同的app_id/文档类型返回的结构及字段不同,参见可识别文档清单。 |
| +result.outputs |
JSON |
识别结果固定放置在outputs.text主键下 |
| +result.pages |
int |
消耗的页数,页数*单价就是本次的实际价格,比如单页图片返回1,多页PDF返回实际PDF页数(截取固定页数PDF的情形除外) |
| error_message |
String |
发生错误后,会返回对应的错误码,具体见下面 ERROR 错误信息 |
# 可识别文档清单
| 分类 |
文档类型 |
app_id |
文档格式 |
文档数量 |
识别结果 |
| 单页版 |
个税实名页 |
builtin-gAeLrmVuidifCLf06u |
图片 |
1 |
查看说明 |
| 单页版 |
出生证明 |
builtin-3tYW8k2OxXqnIgajOu |
图片 |
1 |
查看说明 |
| 单页版 |
户口本 |
builtin-7EjmKh4jgGSSNSRQlq |
图片 |
1 |
查看说明 |
| 单页版 |
房产证 |
builtin-mAOvaiBhGuXBwRR96k |
图片 |
1 |
查看说明 |
| 单页版 |
营业执照 |
builtin-8h2yGTp9Unf8KeSBZq |
图片 |
1 |
查看说明 |
| 单页版 |
信用分 |
builtin-aUjbUT0CS6UnZtkz74 |
图片 |
1 |
查看说明 |
| 单页版 |
交易凭证 |
builtin-3Dz3bZYy9mXJRi6e3n |
图片 |
1 |
查看说明 |
| 单页版 |
可贷额度及利率截图 |
builtin-zxK1rs4dvH1mJdI0q5 |
图片 |
1 |
查看说明 |
| 单页版 |
个人资料页截图 |
builtin-eJdWTFrUPP4S54xM2Y |
图片 |
1 |
查看说明 |
| 单页版 |
车辆保险单 |
builtin-DwzBwL7rslPppm7Le2 |
图片/PDF |
1 |
查看说明 |
| 单页版 |
可信身份证明 |
builtin-6UHdzLvHiVemchOESD |
图片/PDF |
1 |
查看说明 |
| 单页版 |
开户许可证 |
builtin-GFTbAgmeY2OgLyVh0x |
图片 |
1 |
查看说明 |
| 单页版 |
网约车驾驶员证 |
builtin-9FCAHlefg4ZNHCWYeL |
图片 |
1 |
查看说明 |
| 单页版 |
网约车运输证 |
builtin-1KNXQ4U8IPXqLqMzz1 |
图片 |
1 |
查看说明 |
| 单页版 |
收入纳税明细截图 |
builtin-syCQWP6zz1TAyowzsd |
图片 |
1 |
查看说明 |
| 单页版 |
职业资质证书(通用版) |
builtin-bPCLkttMNYZLk7asEj |
图片 |
1 |
查看说明 |
| 多页版 |
交易流水 |
builtin-rG1h1lDdYJLVDH1ujI |
图片/PDF |
1 |
查看说明 |
| 多页版 |
合同信息提取 |
builtin-Dd1BBBlUodCXPn6oRf |
图片/PDF |
1 |
查看说明 |
| 多页版 |
车辆登记证 |
builtin-KTYpLLNy1tkBgTxArG |
图片 |
1-9 |
查看说明 |
| 多页版 |
离境退税单 |
builtin-YJlhoCGNLnzxeQWlwL |
图片 |
1 |
查看说明 |
| 定制版 |
财报解析 |
builtin-5IBkb2yDF5Mg2141NR |
PDF |
1 |
查看说明 |
| 定制版 |
询证函 |
builtin-RpT3crPbHZmpSt58RX |
PDF |
1 |
查看说明 |
| 定制版 |
授权书识别及比对 |
builtin-9TI5CvWUILqqlTnCsa |
图片/PDF |
1-2 |
查看说明 |
| 定制版 |
可信身份证明二要素 |
builtin-8F8h3u8SwuzXqvzA8W |
PDF |
1 |
查看说明 |
| 定制版 |
人像视觉分析 |
builtin-XNYE6KIyksmObERySB |
图片 |
1 |
查看说明 |
| 定制版 |
印章识别及截图 |
builtin-Lf7xLCnp1TMeaDNDgo |
图片/PDF |
1 |
查看说明 |
# 文档识别结果说明
# 个税实名页
| 字段名 |
类型 |
说明 |
示例 |
| 截图 |
bool |
是否为app手机截图 |
true/false |
| 类型 |
string |
“个税”或“其他” |
个税 |
| 姓名 |
string |
截图中显示的姓名 |
孙某 |
| 实名 |
bool |
是否已实名 |
true/false |
# 出生证明
| 字段名 |
类型 |
说明 |
示例 |
| 姓名 |
string |
新生儿姓名 |
张三 |
| 性别 |
string |
新生儿性别 |
男 |
| 出生时间 |
string |
新生儿出生日期及时间,格式为 YYYY-MM-DD HH:mm |
2020-05-02 08:30 |
| 出生地点 |
string |
新生儿出生地点,通常为省/市/区县等行政区划信息 |
河北省邯郸市丛台区 |
| 医疗机构名称 |
string |
新生儿出生所在医疗机构名称 |
北京大学第一医院 |
| 母亲姓名 |
string |
母亲姓名 |
李四 |
| 母亲国籍 |
string |
母亲国籍 |
中国 |
| 母亲民族 |
string |
母亲民族 |
汉族 |
| 母亲住址 |
string |
母亲住址信息 |
北京市海淀区XX路XX号 |
| 母亲证件类型 |
string |
母亲身份证件类型 |
居民身份证 |
| 母亲证件号码 |
string |
母亲身份证件号码 |
110101198811071234 |
| 父亲姓名 |
string |
父亲姓名 |
王五 |
| 父亲国籍 |
string |
父亲国籍 |
中国 |
| 父亲民族 |
string |
父亲民族 |
汉族 |
| 父亲住址 |
string |
父亲住址信息 |
上海市普陀区XX路XX号 |
| 父亲证件类型 |
string |
父亲身份证件类型 |
居民身份证 |
| 父亲证件号码 |
string |
父亲身份证件号码 |
310101198701011234 |
| 签发机构 |
string |
出生医学证明签发机构名称 |
北京市海淀区妇幼保健院 |
| 签发日期 |
string |
出生医学证明签发日期,格式为 YYYY-MM-DD |
2020-05-02 |
| 编号 |
string |
出生医学证明编号,通常为大写字母与数字组成 |
A123456789 |
# 户口本
| 字段名 |
类型 |
说明 |
示例 |
| 姓名 |
string |
户口本成员姓名 |
张三 |
| 曾用名 |
string |
户口本成员曾用名;如无曾用名,可为空 |
张小三 |
| 户主或与户主关系 |
string |
当前成员与户主的关系,或当前页显示的户主身份 |
本人 |
| 户号 |
string |
户口本户号,通常为公安机关户籍系统中的编号 |
123456789 |
| 户籍地址 |
string |
户籍住址信息,通常出现在户主页 |
北京市海淀区XX路XX号 |
| 性别 |
string |
户口本成员性别 |
男 |
| 民族 |
string |
户口本成员民族 |
汉 |
| 出生日期 |
string |
户口本成员出生日期,格式为 YYYY-MM-DD |
1990-01-01 |
| 出生地 |
string |
户口本成员出生地,通常为省/市/区县信息 |
北京市海淀区 |
| 籍贯 |
string |
户口本成员籍贯 |
河北省石家庄市 |
| 身份证号 |
string |
户口本成员身份证号码 |
110101199001011234 |
| 文化程度 |
string |
户口本成员文化程度 |
本科 |
| 婚姻状况 |
string |
户口本成员婚姻状况;常见值包括 未婚、已婚、离异、丧偶;无法识别时可为空 |
已婚 |
| 迁来本市 |
string |
迁入本市的时间、来源地或相关说明 |
2015-06-01由广东省广州市迁入 |
| 迁来本址 |
string |
迁入本址的时间、来源地或相关说明 |
2018-09-01由北京市朝阳区迁入 |
| 登记日期 |
string |
户口登记日期,格式为 YYYY-MM-DD |
2020-05-02 |
# 房产证
| 字段名 |
类型 |
说明 |
示例 |
| 出证日期 |
string |
房产证出证日期或办证日期,格式通常为 YYYY-MM-DD |
2020-05-02 |
| 不动产登记证号 |
string |
不动产登记证完整编号,通常包含地区简称、年份括号和证号 |
沪(2020)不动产权第096354号 |
| 产权人 |
string |
房产证上的产权人或权利人姓名/名称 |
张三 |
| 共有方式 |
string |
房屋共有方式,按证件原文返回,如“单独所有”“共同共有”“按份共有”等 |
单独所有 |
| 坐落 |
string |
房屋坐落地址或抵押物地址,通常包含省市区、路名、门牌号、室号等信息 |
上海市浦东新区XX路XX弄XX号XX室 |
| 用途 |
string |
房本中用途栏对应的文本内容,可能包含土地用途、房屋用途等信息 |
城镇住宅用地 住宅 |
| 建筑面积 |
string |
建筑面积,单位为平方米,只保留数字 |
89.32 |
| 总楼层 |
string |
建筑总层数,只保留数字 |
18 |
| 所在层 |
string |
该套房屋所在楼层;复式或跨层可返回区间形式 |
6 |
| 建成年代 |
string |
房屋建成年份或竣工日期信息;精确到年返回 YYYY,精确到月返回 YYYY-MM,精确到日返回 YYYY-MM-DD |
2018 |
| 共有权明细 |
array |
共有权人明细列表;如证件中无共有权明细,可返回空数组 |
- |
| +共有权人 |
string |
共有权人的姓名/名称 |
李四 |
| +证号 |
string |
共有权人对应的房屋所有权证号或相关证号 |
沪房地浦字(2020)第000123号 |
| +共有比例 |
string |
共有权人所占比例,通常为百分比形式 |
50% |
# 营业执照
| 字段 |
类型 |
含义 |
示例 |
| 是否副本 |
string |
营业执照版本类型,副本、非副本 |
副本 |
| 统一社会信用代码 |
string |
企业统一社会信用代码 |
91210900MACF41Q107 |
| 注册号 |
string |
工商注册号(部分旧版营业执照存在) |
110108000000000 |
| 名称 |
string |
企业主体名称 |
XXX控股(辽宁)集团有限公司 |
| 类型 |
string |
企业类型/市场主体类型 |
有限责任公司 |
| 法定代表人 |
string |
企业法定代表人姓名 |
聂文忠 |
| 注册资本 |
string |
企业注册资本金额及单位 |
人民币壹亿元整 |
| 成立日期 |
string |
企业成立日期,YYYY-MM-DD |
2023-04-19 |
| 营业期限 |
string |
营业执照营业期限原文 |
长期 |
| 营业开始日期 |
string |
营业期限开始日期,YYYY-MM-DD |
2023-04-19 |
| 营业结束日期 |
string |
营业期限结束日期,YYYY-MM-DD |
2043-04-18 |
| 注册地址 |
string |
企业注册地址 |
辽宁省阜新高新技术产业开发区盛祥路17号 |
| 经营范围 |
string |
企业经营范围描述 |
企业管理、信息技术咨询服务…… |
| 组成形式 |
string |
个体工商户组成形式 |
个人经营 / 家庭经营等 |
# 信用分截图
| 字段名 |
类型 |
说明 |
示例 |
| 姓名 |
string |
当前信用分所属用户的姓名;如姓名中存在星号脱敏,返回包含星号的完整展示内容 |
孙*文 |
| 信用分值 |
number |
信用分截图中显示的分值 |
750 |
| 信用分类型 |
string |
信用分所属平台类型;可选值包括 芝麻信用分、微信支付分、其他 |
芝麻信用分 |
# 交易凭证
| 字段名 |
类型 |
说明 |
示例 |
| 交易金额 |
string |
交易、订单或转账金额,一般精确到小数点后 2 位,不包含货币符号 |
1000.00 |
| 币种 |
string |
交易币种名称 |
人民币 |
| 付款方 |
string |
付款方主体名称,可能为个人姓名或企业名称;如凭证中未显示,可为空 |
张三 |
| 付款方账号 |
string |
付款方银行账号或支付平台账号,可能为完整账号、尾号或脱敏账号 |
622202****1234 |
| 付款方开户行 |
string |
付款方开户行名称或交易平台名称 |
中国建设银行 |
| 收款方 |
string |
收款方或对方主体名称,可能为个人姓名或企业名称 |
XX市XX公司 |
| 收款方账号 |
string |
收款方银行账号或支付平台账号,可能为完整账号、尾号或脱敏账号 |
622848****5678 |
| 收款方开户行 |
string |
收款方开户行名称或交易平台名称 |
中国工商银行 |
| 交易时间 |
string |
转账或交易时间,格式为 YYYY-MM-DD HH:mm:ss |
2024-03-03 10:30:00 |
| 交易流水号 |
string |
能唯一代表本次交易的流水号、交易编号、订单号或凭证号 |
202403031234567890 |
| 备注 |
string |
本次交易或转账相关备注、附言、用途等信息;如无可返回空字符串 |
房租 |
# 可贷额度及利率截图
| 字段名 |
类型 |
说明 |
示例 |
| 截图 |
boolean |
是否为 App 手机截图 |
true |
| 类型 |
string |
截图页面类型,可选值有"额度""实名""身份证""其他",分别对应额度页截图,实名页截图,身份证照片,其他截图 |
额度 |
| 平台 |
string |
可贷额度或利率信息所属平台;可选值包括 借呗、抖音放心借、度小满、微粒贷、京东金条、抖音外导、借呗外导、精选贷、其他 |
抖音放心借 |
| 可借额度 |
string |
当前页面显示的可借款额度,金额字符串通常精确到小数点后 2 位 |
452500.00 |
| 总额度 |
string |
当前页面显示的总额度;如无可为空字符串 |
500000.00 |
| 年利率 |
string |
年利率数值,不包含百分号,精确到小数点后 2 位 |
12.60 |
| 优惠利率 |
string |
享受折扣或优惠后的利率数值,不包含百分号,精确到小数点后 2 位 |
12.24 |
| 新人 |
boolean |
是否存在新人优惠政策、新人广告或新人权益信息 |
true |
| 还款日 |
number |
每月还款日,返回日期数字 |
7 |
| 应还金额 |
string |
页面显示的应还金额,通常精确到小数点后 2 位 |
7915.15 |
| 时间 |
string |
当前手机截图顶部状态栏显示的时间,格式为 HH:MM |
10:25 |
| 电量 |
string |
当前手机剩余电量比例,不包含百分号 |
31 |
| 系统 |
string |
手机系统类型;可选值包括 苹果、安卓、鸿蒙 |
安卓 |
| 机型 |
string |
手机型号或机型代码 |
CPH2195 |
| 截图时间 |
string |
截图生成或识别到的截图时间,格式为 YYYY-MM-DD HH:MM:SS |
2025-12-10 10:25:14 |
| 宽 |
number |
截图宽度,单位为像素 |
1080 |
| 高 |
number |
截图高度,单位为像素 |
2400 |
# 个人资料页截图
| 字段名 |
类型 |
说明 |
示例 |
| 截图 |
boolean |
是否为 App 手机截图 |
true |
| 平台 |
string |
个人资料页所属平台;可选值包括 借呗、抖音放心借、度小满、微粒贷、京东金条、其他 |
度小满 |
| 认证状态 |
string |
用户认证状态;可选值包括 已认证、未认证、null |
已认证 |
| 姓名 |
string |
页面中显示的用户姓名,可能为完整姓名或脱敏姓名 |
郑** |
| 手机号 |
string |
页面中显示的用户手机号,可能为完整手机号或脱敏手机号 |
137****7825 |
| 时间 |
string |
当前手机截图顶部状态栏显示的时间,格式为 HH:MM |
10:25 |
| 电量 |
string |
当前手机剩余电量比例,不包含百分号 |
31 |
| 系统 |
string |
手机系统类型;可选值包括 苹果、安卓、鸿蒙 |
安卓 |
| 机型 |
string |
手机型号或机型代码 |
CPH2195 |
| 截图时间 |
string |
截图生成或识别到的截图时间,格式为 YYYY-MM-DD HH:MM:SS |
2025-12-10 10:25:14 |
| 宽 |
number |
截图宽度,单位为像素 |
1080 |
| 高 |
number |
截图高度,单位为像素 |
2400 |
# 车辆保险单
| 字段名 |
类型 |
说明 |
示例 |
| 险种 |
string |
保单对应的保险大类类型;可选值包括 交强险、商业险 |
交强险 |
| 保单生成时间 |
string |
保单生成、保费确认、打印或其他业务操作时间,格式为 YYYY-MM-DD HH:MM:SS |
2026-05-09 10:51:00 |
| 保险单号 |
string |
车辆保险单号 |
PDZA202664010000209595 |
| 被保险人 |
string |
被保险人姓名或组织名称 |
宁夏XX汽车服务有限公司 |
| 发动机号 |
string |
车辆发动机号或发动机号码 |
CRSJC0550 |
| 厂牌型号 |
string |
车辆厂牌型号,通常包含厂家、品牌、型号或用途信息 |
奇瑞SQR648XXT285插电式混合动力多用途乘用车 |
| 车架号 |
string |
车辆识别代码、车架号或 VIN 码 |
LNNBBDEE2SG136418 |
| 使用性质 |
string |
车辆使用性质 |
企业非营业客车 |
| 登记日期 |
string |
被保险机动车登记日期;精确到月返回 YYYY-MM,精确到日返回 YYYY-MM-DD |
2026-03-13 |
| 保费 |
string |
保险费用合计或总计小写金额,精确到小数点后 2 位,不包含货币单位 |
1130.00 |
| 车船税 |
string |
代收车船税合计小写金额,精确到小数点后 2 位,不包含货币单位 |
360.00 |
| 三者险金额 |
string |
机动车第三者责任保险的保险金额或责任限额,精确到小数点后 2 位,不包含货币单位 |
2000000.00 |
| 起保时间 |
string |
保险期间开始时间,格式为 YYYY-MM-DD HH:MM:SS |
2026-05-10 00:00:00 |
| 终保时间 |
string |
保险期间结束时间,格式为 YYYY-MM-DD HH:MM:SS |
2027-05-09 23:59:59 |
| 省份 |
string |
保险人或保险公司地址中的省份/直辖市信息 |
宁夏 |
| 城市 |
string |
保险人或保险公司地址中的城市信息 |
银川市 |
# 可信身份证明
| 字段名 |
类型 |
说明 |
示例 |
| 凭据编号 |
string |
可信身份证明对应的凭据编号 |
3c5462XXXXX9bc |
| 认证结果 |
string |
身份认证结果信息,通常包含是否通过及认证要素说明 |
已通过(姓名+公民身份号码+人像) |
| 认证平台 |
string |
可信身份认证平台名称 |
“互联网+”可信身份认证平台 |
| 创建日期 |
string |
可信身份证明创建日期,格式为 YYYY-MM-DD |
2024-03-14 |
| 存证编号 |
string |
可信身份证明对应的存证编号 |
4290348XXXeBwcoyehcoiwhceq |
| 照片 |
string |
认证照片的 Base64 字符串或图片数据内容 |
/9j/4AAQSkZJRgABAgAAAQABAAD... |
# 开户许可证
| 字段名 |
类型 |
说明 |
示例 |
| 类型 |
string |
材料类型;可选值包括 开户许可证、基本存款账户信息、交易回单、网银系统截图、银行APP截图、印鉴卡、银行卡、银行业务凭证、其他 |
开户许可证 |
| 账户 |
array |
材料中识别出的一个或多个账户及主体信息 |
- |
| +客户 |
string |
账户所属客户名称,可能为企业名称或自然人姓名 |
杭州xx净化设备有限公司 |
| +法人 |
string |
企业法人姓名;通常在开户许可证、基本存款账户信息等企业账户材料中出现 |
李斌 |
| +银行 |
string |
开户银行全称或交易相关银行名称 |
浙江建德农村商业银行股份有限公司寿昌支行 |
| +账号 |
string |
银行账号或银行卡号 |
2010000xxx28682 |
| +日期 |
string |
发证日期、许可日期、交易日期或材料中的相关业务日期,格式为 YYYY-MM-DD |
2020-12-29 |
| 印章 |
array |
材料中识别出的一个或多个印章信息 |
- |
| +类型 |
string |
印章类型;可选值包括 公章、个人章、专用章、合同专用章、财务专用章、发票专用章、业务专用章、其他 |
专用章 |
| +内容 |
string |
印章中显示的文字、编号或其他可见内容 |
XXX有限公司 6108025150380 |
# 网约车驾驶员证
| 字段名 |
类型 |
说明 |
示例 |
| 姓名 |
string |
网约车驾驶员姓名 |
李承浩 |
| 性别 |
string |
网约车驾驶员性别 |
男 |
| 出生日期 |
string |
网约车驾驶员出生日期,格式为 YYYY-MM-DD |
1986-07-14 |
| 国籍 |
string |
网约车驾驶员国籍 |
中国 |
| 住址 |
string |
网约车驾驶员住址信息 |
山东省烟台市芝罘区南山花苑9号楼xx室 |
| 证号 |
string |
网约车驾驶员证件号码 |
370685198607140521 |
| 准驾车型 |
string |
准许驾驶的车型或证件中显示的准驾车型说明 |
以驾驶证准驾车型为准 |
| 领证日期 |
string |
网约车驾驶员证领证日期,格式为 YYYY-MM-DD |
2025-10-15 |
| 起始日期 |
string |
网约车驾驶员证有效期起始日期,格式为 YYYY-MM-DD |
2025-10-15 |
| 截止日期 |
string |
网约车驾驶员证有效期截止日期,格式为 YYYY-MM-DD |
2050-10-15 |
| 机关 |
string |
发证机关或管理机关名称 |
烟台市公安局交通管理支队 |
# 网约车运输证
| 字段名 |
类型 |
说明 |
示例 |
| 证号 |
string |
网约车运输证证号或道路运输证相关许可编号 |
苏交运管许可苏字202412345号 |
| 所有人 |
string |
车辆所有人姓名或单位名称 |
张建国 |
| 地址 |
string |
车辆所有人地址或证件中显示的联系地址 |
江苏省苏州市吴中区东湖花园148号2幢552室 |
| 车牌 |
string |
车辆号牌号码 |
苏EAB3333 |
| 类型 |
string |
车辆类型 |
小型普通客车 |
| 座数 |
string |
车辆核定座位数 |
5 |
| 范围 |
string |
车辆经营范围或运输范围 |
网络预约出租汽车客运 |
| 发证日 |
string |
网约车运输证发证日期,格式为 YYYY-MM-DD |
2024-09-18 |
| 截止日 |
string |
网约车运输证有效期截止日期,格式为 YYYY-MM-DD |
2032-03-25 |
| 机关 |
string |
发证机关或管理机关名称 |
苏州市交通运输局 |
# 收入纳税明细截图
| 字段名 |
类型 |
说明 |
示例 |
| 合计 |
string |
收入合计金额,精确到小数点后 2 位,不包含货币单位 |
3158393.12 |
| 已申报 |
string |
已申报税额或已申报金额,精确到小数点后 2 位,不包含货币单位 |
1089335.51 |
| 明细 |
array |
收入纳税明细列表 |
- |
| +月份 |
string |
收入所属月份,格式为 YYYY-MM |
2022-06 |
| +类别 |
string |
收入类别或所得项目 |
正常工资薪金 |
| +扣缴人 |
string |
扣缴义务人名称,通常为公司或机构名称 |
xx科技有限公司 |
| +收入 |
string |
当前明细项收入金额,精确到小数点后 2 位,不包含货币单位 |
544490.35 |
| +税额 |
string |
当前明细项税额,精确到小数点后 2 位,不包含货币单位 |
241627.85 |
# 职业资质证书(通用版)
| 字段名 |
类型 |
说明 |
示例 |
| 证书类型 |
string |
通用字段,识别出的职业资质证书类型;如无法匹配具体类型,可返回 其他 |
教师资格证 |
| 姓名 |
string |
通用字段,持证人姓名,优先返回证书上显示的中文姓名 |
张三 |
| 证件号码 |
string |
通用字段,持证人的身份证号、证件号码、身份证件号或其他身份证明号码 |
110101199001011234 |
| 证书编号 |
string |
通用字段,证书上的证书编号、管理号、统一编号、证书号码、编号等唯一标识 |
202401234567 |
| 颁证日期 |
string |
通用字段,证书颁发、签发、批准、认定或发证日期;精确到日返回 YYYY-MM-DD,精确到月返回 YYYY-MM |
2024-05-20 |
| 证书名称 |
string |
通用字段,证书上显示的证书名称、资格名称、职业资格名称或资质名称 |
教师资格证 |
| 有效期 |
string |
个性化字段,证书有效期、截止日期或有效期区间;可为日期、日期区间或“长期”等文字描述 |
2024-05-20至2029-05-19 |
| 性别 |
string |
个性化字段,部分证书中显示的持证人性别 |
男 |
| 出生年月 |
string |
个性化字段,部分证书中显示的出生年月或出生日期;精确到月返回 YYYY-MM,精确到日返回 YYYY-MM-DD |
1990-01 |
| 民族 |
string |
个性化字段,部分证书中显示的持证人民族 |
汉族 |
| 级别 |
string |
个性化字段,专业技术资格类证书中显示的级别、等级或资格级别 |
中级 |
| 专业 |
string |
个性化字段,专业技术资格、医师、母婴保健等证书中显示的专业、专业类别或专业方向 |
计算机技术与软件 |
| 职业资格 |
string |
个性化字段,消防、应急救援、健身娱乐场所服务等证书中显示的职业资格名称 |
消防设施操作员 |
| 职业名称 |
string |
个性化字段,道路运输从业人员等证书中显示的职业名称 |
道路旅客运输驾驶员 |
| 职业技能等级 |
string |
个性化字段,职业技能等级证书中显示的职业类型和技能等级 |
焊工 高级 |
| 岗位名称 |
string |
个性化字段,母婴保健、育婴、护理等证书中显示的岗位名称或岗位等级 |
母婴护理师 高级 |
| 资格种类 |
string |
个性化字段,教师资格证等证书中显示的资格种类 |
小学教师资格 |
| 任教学科 |
string |
个性化字段,教师资格证等证书中显示的任教学科 |
语文 |
| 认定学段 |
string |
个性化字段,教师资格证等证书中对应的认定学段 |
小学 |
| 发证机关 |
string |
个性化字段,证书发证机关、批准机关、签发机关或认定机构 |
北京市教育委员会 |
| 执业地点 |
string |
个性化字段,医师等执业类证书中显示的执业地点 |
北京市 |
| 主要执业机构 |
string |
个性化字段,医师等执业类证书中显示的主要执业机构 |
北京大学第一医院 |
| 执业范围 |
string |
个性化字段,医师等执业类证书中显示的执业范围 |
内科专业 |
| 执业类别 |
string |
个性化字段,医师等执业类证书中显示的执业类别 |
临床 |
| 毕业院校 |
string |
个性化字段,医师等证书中显示的毕业院校 |
北京大学医学部 |
| 学历 |
string |
个性化字段,医师等证书中显示的学历 |
本科 |
| 序列号No |
string |
个性化字段,部分证书上 No 后的序列号,不包含 No 标识 |
123456789 |
| 操作类别 |
string |
个性化字段,建筑施工特种作业人员等证书中显示的操作工种类别 |
建筑电工 |
| 申报等级 |
string |
个性化字段,安全保护服务人员等证书中显示的申报等级信息 |
四级 |
| 证书类别 |
string |
个性化字段,船员资格证等证书中显示的证书类别或级别信息 |
一类 |
| 职务资格 |
string |
个性化字段,船员资格证等证书中显示的职务资格或职务名称 |
船长 |
| 从业证书类型 |
string |
个性化字段,证券、期货、基金等从业资格证书中显示的证书类型或执业类型 |
基金从业资格 |
# 交易流水
说明:交易流水支持图片/PDF格式的微信、支付宝、银行流水识别。
| 字段名 |
类型 |
说明 |
示例 |
| title |
string |
银行流水或交易明细文件标题 |
中国建设银行个人活期账户全部交易明细 |
| resource |
object |
解析后的 Excel 文件地址,超5分钟后失效 |
- |
| +xlsx_url |
string |
解析生成的 Excel 文件下载地址 |
https://xxx.xlsx |
| key_extraction |
object |
银行流水中的账户、客户、起止日期等关键信息(下面为示例) |
- |
| +卡号/账号 |
string |
银行卡号、账户号或账号 |
6217004220002969172 |
| +客户名称 |
string |
账户所属客户名称 |
高龙飞 |
| +起始日期 |
string |
流水起始日期,通常为 YYYY-MM-DD 或原始日期格式 |
2023-09-07 |
| +结束日期 |
string |
流水结束日期,通常为 YYYY-MM-DD 或原始日期格式 |
2024-03-07 |
| details |
array |
原始交易明细列表,保留原始表头和原始字段;不同银行或不同版式的字段可能不同(下面为示例) |
- |
| +序号 |
string |
原始流水中的交易序号字段;如原表无该字段,则不会返回 |
571 |
| +摘要 |
string |
原始流水中的交易摘要、业务摘要或交易类型字段 |
跨行自助取款 |
| +币别 |
string |
原始流水中的币种字段 |
人民币元 |
| +钞汇 |
string |
原始流水中的钞汇标识字段 |
钞 |
| +交易日期 |
string |
原始流水中的交易日期字段,按原始表头和原始内容返回 |
20240216 |
| +交易金额 |
string |
原始流水中的交易金额字段,保留原始正负号、千分位或金额格式 |
-1,000.00 |
| +账户余额 |
string |
原始流水中的账户余额字段,保留原始金额格式 |
0.51 |
| +交易地点/附言 |
string |
原始流水中的交易地点、附言、用途、备注等字段,字段名以原表头为准 |
陕西省西安市周至县哑柏镇东街 |
| +对方账号与户名 |
string |
原始流水中的对方账号、对方户名或交易对手信息,字段名以原表头为准 |
443713356/高龙飞 |
| +其他原始字段 |
string/object/number |
其他未列出的原始表头字段,按银行流水原表头动态返回 |
见原始表头 |
| normalized |
array |
归一化交易明细列表,字段固定,用于统一处理和统计分析 |
- |
| +Transaction_Time |
string |
交易时间,格式为 YYYY-MM-DD HH:mm:ss;如原文仅有日期,时间补全为 00:00:00 |
2024-02-17 00:00:00 |
| +Summary |
string |
交易摘要、交易类型或业务说明 |
银联入账 |
| +Credit/Debit |
string |
收支方向;可选值通常为 收入、支出 |
收入 |
| +Transaction_Amount |
number |
交易金额,正数表示金额绝对值 |
10000 |
| +Balance |
number |
当前交易后的账户余额 |
10000.51 |
| +Counterparty_Name |
string |
对方账号、户名或交易对手信息 |
443713356/高龙飞 |
| +Remark |
string |
交易备注、附言、交易地点或补充说明 |
微信零钱提现微信零钱提现 |
# 合同信息提取
| 字段名 |
类型 |
说明 |
示例 |
| 合同名称 |
string |
合同文件中显示的合同名称或标题; |
借款合同 |
| 合同类型 |
string |
合同所属类型或业务类别; |
借款合同 |
| 合同编号 |
string |
合同编号、协议编号、订单编号或其他可用于标识合同的编号 |
E1D5126217B3EFDA3513820 |
| 甲方 |
string |
合同甲方名称,可能为个人姓名、企业名称或机构名称; |
北京某某科技有限公司 |
| 乙方 |
string |
合同乙方名称,可能为个人姓名、企业名称或机构名称; |
张三 |
| 签署日期 |
string |
合同签署日期,格式为 YYYY-MM-DD; |
2023-05-29 |
| 合同标的 |
string |
合同约定的交易对象、服务内容、项目名称、借款事项或其他核心标的内容; |
车辆融资租赁服务 |
| 合同金额 |
string |
合同中约定的金额,通常保留金额数字,不包含货币单位; |
100000.00 |
# 车辆登记证
支持传入同一车辆的信息栏页面、登记栏页面或多张混合页面,接口均固定返回以下结构:
1234
{
"信息栏": {},
"登记栏": {}
}
-信息栏: 存放机动车登记证书首页(信息栏)的识别结果。未识别到有效信息栏页面时返回空对象 {}。
-登记栏: 存放一个或多个登记栏页面的合并结果。未识别到有效登记栏页面时返回空对象 {}。
当一次传入多个登记栏页面时,同名记录列表会自动合并;包含有效日期的记录按日期倒序排列。无法识别的页面不参与合并。
# 信息栏页面外层识别结果
| 字段名 |
类型 |
说你 |
示例 |
| 转移登记摘要 |
array object |
转移登记摘要信息列表,按证件中展示顺序返回 |
[{"转移机动车所有人":"张三","转移身份证明名称":"居民身份证","转移号码":"3301021xxxx1234","转移登记机关":"杭州市公安局交通警察支队","转移登记日期":"2023-05-12","转移登记编号":"A123456"}] |
| 机动车登记信息 |
object |
当前机动车的登记信息对象,包含车辆所有人、登记机关、车辆基础参数等字段 |
{"编号":"5200081","机动车所有人":"刘某","身份证明名称":"居民身份证"......} |
| 页面类型 |
string |
当前页面类型,信息栏固定返回该值 |
信息栏 |
# 信息栏页面--机动车登记信息识别结果
| 字段名 |
类型 |
说明 |
示例 |
| 编号 |
string |
机动车登记信息中的编号 |
5200081 |
| 机动车所有人 |
string |
当前机动车所有人姓名或名称,保留原文 |
刘某 |
| 身份证明名称 |
string |
机动车所有人的身份证明名称,保留原文 |
居民身份证 |
| 号码 |
string |
机动车所有人的身份证明号码,保留原文 |
5222219 |
| 登记机关 |
string |
当前机动车登记机关名称,保留原文 |
贵州省铜仁市公安局交通警察支队 |
| 登记日期 |
string |
当前机动车登记日期,统一输出为 YYYY-MM-DD |
2015-04-02 |
| 机动车登记编号 |
string |
机动车登记编号,保留原文 |
贵D0xx7 |
| 车辆类型 |
string |
车辆类型,保留原文 |
小型普通客车 |
| 车辆品牌 |
string |
车辆品牌,保留原文 |
汽牌 |
| 车身颜色 |
string |
车身颜色,保留原文 |
红 |
| 车辆型号 |
string |
车辆型号,保留原文 |
CA64E5TK |
| 车辆识别代号/车架号 |
string |
车辆识别代号或车架号,保留原文 |
LFBG334 |
| 国产/进口 |
string |
车辆来源属性,通常为“国产”或“进口” |
国产 |
| 发动机号 |
string |
发动机号码,保留原文 |
010935 |
| 发动机型号 |
string |
发动机型号,保留原文 |
CA4GCxx8T |
| 燃料种类 |
string |
燃料种类,保留原文 |
汽油 |
| 排量 |
string |
发动机排量,通常为数字字符串 |
1786 |
| 功率 |
string |
发动机功率,通常为数字字符串 |
137 |
| 制造厂名称 |
string |
车辆制造厂名称,保留原文 |
中国第一汽车集团公司 |
| 转向形式 |
string |
转向形式,保留原文 |
方向盘 |
| 前轮距(mm) |
string |
前轮距,单位为毫米 |
1580 |
| 后轮距(mm) |
string |
后轮距,单位为毫米 |
1580 |
| 轮胎数 |
string |
轮胎数量,通常为数字字符串 |
4 |
| 轮胎规格 |
string |
轮胎规格,保留原文 |
215/60R17 |
| 钢板弹簧片数 |
string |
钢板弹簧片数,保留原文;无值时返回空字符串 |
"" |
| 轴距(mm) |
string |
轴距,单位为毫米 |
2675 |
| 轴数 |
string |
车轴数量,通常为数字字符串 |
2 |
| 外扩尺寸(mm) |
string |
车辆外廓尺寸,通常格式为长/宽/高 |
4586/1820/1695 |
| 货厢内部尺寸(mm) |
string |
货厢内部尺寸,保留原文;无值时返回空字符串 |
"" |
| 总质量(kg) |
string |
总质量,单位为千克 |
2100 |
| 核定载质量(kg) |
string |
核定载质量,单位为千克;无值时返回空字符串 |
"" |
| 核定载客(人) |
string |
核定载客人数 |
5 |
| 准牵引总质量(kg) |
string |
准牵引总质量,单位为千克;无值时返回空字符串 |
"" |
| 驾驶室载客(人) |
string |
驾驶室载客人数;无值时返回空字符串 |
"" |
| 使用性质 |
string |
车辆使用性质,保留原文 |
非营运 |
| 车辆获得方式 |
string |
车辆获得方式,保留原文 |
购买 |
| 车辆出厂日期 |
string |
车辆出厂日期,统一输出为 YYYY-MM-DD |
2014-11-28 |
| 发证日期 |
string |
发证日期,统一输出为 YYYY-MM-DD |
2015-04-02 |
| 签发机关章 |
string |
签发机关章文字内容,保留原文 |
贵州省铜仁市公安局交通警察支队 |
| 是否红章 |
string |
是否检测到红章,通常 1 表示有红章,0 表示无红章 |
1 |
| 页码 |
string |
当前页码信息 |
第1页 |
# 登记栏页面识别结果说明
| 字段名 |
类型 |
说明 |
示例 |
| 证书编号 |
string |
机动车登记证书编号,通常为右上角红色编号 |
330043819147 |
| 页码 |
string |
当前页页码;若同一页识别到两个页码,取较大的那个;仅保留纯数字字符串 |
3 |
| 抵押(含质押)及解除登记信息 |
array object |
将“抵押登记/质押备案信息”与“解除抵押/质押信息”合并后的统一列表。若所有日期均合法,则按日期倒序排列;同日期下“抵押/质押登记”优先于“解除抵押/质押” |
[{"类型":"抵押登记/质押备案","抵押登记-抵押权人姓名/名称":"xxx融资租赁有限公司","抵押登记-身份证明名称/号码":"统一社会信用代码/91110000xxx531XJ","抵押登记日期":"2026-04-03"},{"类型":"解除抵押/解除质押","解除抵押日期":"2026-03-24"}] |
| 转移转让登记信息 |
array object |
转移转让登记信息列表,按证件中出现顺序输出 |
[{"转移登记-姓名/名称":"张三","转移登记-身份证明名称/号码":"居民身份证/330102xxxx1011234","转移登记-获得方式":"购买","转移登记日期":"2025-10-13","转移登记-转入地车辆管理所名称":"杭州市公安局交通警察支队车辆管理所","转移登记-机动车登记编号":"A1234567"}] |
| 补领登记证书 |
array object |
补领登记证书记录列表 |
[{"补领原因":"遗失","补领次数":"1","补领日期":"2025-01-10"}] |
| 换领登记证书 |
array o bject |
换领登记证书记录列表 |
[{"换领日期":"2024-08-20"}] |
| 变更登记 |
array object |
变更登记记录列表;同一次变更登记下多个变更事项可拆成多条 |
[{"变更事项":"姓名/名称","变更内容":"金奇x","变更登记日期":"2026-03-24"}] |
| 变更备案 |
array object |
变更备案记录列表;同一次变更备案下多个变更事项可拆成多条 |
[{"变更事项":"车辆识别代号/车架号","变更内容":"重新打刻车辆识别代号(车架号)","变更备案日期":"2025-06-18"}] |
| 作废 |
array object |
作废信息记录列表 |
[{"作废内容":"第8页第3-6行作废","作废日期":"2025-06-18"}] |
# 离境退税单
说明:离境退税单返回结果为数组结构,数组中每个对象对应一张离境退税申请单。返回内容通常包含单据标题、印章信息、申请单头部信息、二维码信息、商品明细和合计信息。
| 字段名 |
类型 |
说明 |
示例 |
| title |
string |
单据标题或文档名称 |
境外旅客购物离境退税申请单 |
| seal_info |
object |
印章识别信息 |
- |
| +has_store_seal |
boolean |
是否识别到商店印章 |
true |
| +has_customs_seal |
boolean |
是否识别到海关验讫章或海关印章 |
true |
| header |
object |
申请单头部信息 |
- |
| +key_extraction |
object |
申请单头部关键字段信息 |
- |
| ++商店名称 |
string |
开具离境退税申请单的商店名称 |
上海禄泰实业有限公司重庆第五分公司 |
| ++商店代码 |
string |
离境退税商店代码 |
5001030053 |
| ++开单日期 |
string |
申请单开具日期,通常格式为 YYYY/MM/DD 或 YYYY-MM-DD |
2026/05/24 |
| ++证件签发国/地区 |
string |
旅客证件签发国家或地区代码 |
IDN |
| ++证件类型 |
string |
旅客身份证件类型 |
护照 |
| ++入境日期 |
string |
旅客入境日期,通常格式为 YYYY/MM/DD 或 YYYY-MM-DD |
2026/05/17 |
| ++申请单编号 |
string |
离境退税申请单编号 |
5001030053260524J81F8 |
| ++姓名 |
string |
境外旅客姓名 |
SUGIANTO ALEX |
| ++证件号码 |
string |
旅客证件号码 |
E7143809 |
| qr_code |
object |
二维码识别信息 |
- |
| +text |
string |
二维码中解析出的文本内容 |
@@5001030053260524J81F8@@AB@@SUGIANTO ALEX@@E7143809@@ |
| table_content |
object |
商品明细表格及合计信息 |
- |
| +content |
array |
商品明细列表,每项对应一行商品明细 |
- |
| ++序号 |
string |
商品明细序号 |
1 |
| ++购物发票号码 |
string |
对应购物发票号码 |
26502000000980758051 |
| ++发票开具日期 |
string |
购物发票开具日期,通常格式为 YYYY/MM/DD 或 YYYY-MM-DD |
2026/05/24 |
| ++商品名称 |
string |
商品名称 |
服装 |
| ++商品类别 |
string |
商品类别 |
运动服装 |
| ++数量 |
string |
商品数量 |
2 |
| ++计量单位 |
string |
商品计量单位 |
件 |
| ++单价 |
string |
商品单价,通常保留两位小数,不包含货币单位 |
262.04 |
| ++金额 |
string |
商品不含税金额或金额栏数值,通常保留两位小数 |
524.07 |
| ++税额 |
string |
商品对应税额,通常保留两位小数 |
68.13 |
| ++价税合计 |
string |
商品价税合计金额,通常保留两位小数 |
592.20 |
| ++退税率 |
string |
商品适用退税率,通常包含百分号 |
11.00% |
| ++申请退税额 |
string |
当前商品明细申请退税金额,通常保留两位小数 |
65.14 |
| ++海关核准退税物品数量 |
string |
海关核准的退税物品数量;如未填写可为空字符串 |
|
| ++备注 |
string |
当前商品明细备注信息;如无可为空字符串 |
|
| +total |
object |
商品明细合计信息 |
- |
| ++序号 |
string |
合计行标识 |
合计Total |
| ++金额 |
string |
金额合计,通常保留两位小数 |
1256.82 |
| ++税额 |
string |
税额合计,通常保留两位小数 |
163.38 |
| ++价税合计 |
string |
价税合计总额,通常保留两位小数 |
1420.20 |
| ++申请退税额 |
string |
申请退税额合计,通常保留两位小数 |
156.22 |
| ++其他合计字段 |
string |
合计行中其他表头字段,字段名与明细表头保持一致;无值时可为空字符串 |
|
# 财报解析
说明:财报解析主要提取资产负债表和利润表中的关键财务指标。返回结果包含报表日期、报表周期、资产负债表字段和利润表字段。金额类字段统一以字符串返回,以保留原表小数位精度;若原字段为空白或未出现,可返回 null。不同报表可能使用不同金额单位,因此资产负债表和利润表分别返回各自的金额单位。
| 字段名 |
类型 |
说明 |
示例 |
| 报表日期 |
string |
财务报表报告日期;精确到月返回 YYYY-MM,精确到日返回 YYYY-MM-DD |
2024-06-30 |
| 周期 |
string |
报表周期;可选值包括 月报、季报、半年报、年报 |
半年报 |
| 资产负债表 |
object |
资产负债表关键指标信息 |
- |
| +金额单位 |
string/null |
资产负债表对应的金额单位,如 元、万元;若原表未标注则返回 null |
万元 |
| +应收账款_期初 |
string/null |
资产负债表中应收账款的期初金额,保留原表小数位,不包含千分位分隔符 |
1234.50 |
| +应收账款_期末 |
string/null |
资产负债表中应收账款的期末金额,保留原表小数位,不包含千分位分隔符 |
1560.00 |
| +负债合计_期末 |
string/null |
资产负债表中负债合计的期末金额,保留原表小数位,不包含千分位分隔符 |
8500.25 |
| +资产总计_期末 |
string/null |
资产负债表中资产总计的期末金额,保留原表小数位,不包含千分位分隔符 |
20000.00 |
| +短期借款_期末 |
string/null |
资产负债表中短期借款的期末金额,保留原表小数位,不包含千分位分隔符 |
3000.00 |
| +一年内到期的非流动负债_期末 |
string/null |
资产负债表中一年内到期的非流动负债期末金额,保留原表小数位,不包含千分位分隔符 |
500.00 |
| +长期借款_期末 |
string/null |
资产负债表中长期借款的期末金额,保留原表小数位,不包含千分位分隔符 |
1200.00 |
| +应付债券_期末 |
string/null |
资产负债表中应付债券的期末金额,保留原表小数位,不包含千分位分隔符 |
800.00 |
| +长期应付款_期末 |
string/null |
资产负债表中长期应付款的期末金额,保留原表小数位,不包含千分位分隔符 |
300.00 |
| +应付利息_期末 |
string/null |
资产负债表中应付利息的期末金额,保留原表小数位,不包含千分位分隔符 |
25.50 |
| +所有者权益合计_期末 |
string/null |
资产负债表中所有者权益合计的期末金额,保留原表小数位,不包含千分位分隔符 |
11500.00 |
| 利润表 |
object |
利润表或损益表关键指标信息 |
- |
| +金额单位 |
string/null |
利润表对应的金额单位,如 元、万元;若原表未标注则返回 null |
万元 |
| +营业收入_期末 |
string/null |
利润表中营业收入的期末金额,保留原表小数位,不包含千分位分隔符 |
9800.00 |
| +净利润_期末 |
string/null |
利润表中净利润的期末金额,保留原表小数位,不包含千分位分隔符 |
1200.35 |
# 询证函
说明:询证函返回结果为数组结构,数组中每个对象对应一份询证函或回证函信息。若同一文件中包含多份询证函信息,可返回多条记录。
| 字段名 |
类型 |
说明 |
示例 |
| 询证函名称 |
string |
询证函、回证函或相关函件名称 |
验资业务银行询证函 |
| 回函地址 |
string |
询证函中显示的回函地址、邮寄地址或接收地址 |
北京市西城区金融大街甲15号财政部监管司办公楼302室 |
| 电话 |
string |
询证函中显示的联系电话 |
010-68512345 |
| 联系人 |
string |
询证函中显示的联系人姓名 |
张伟 |
# 授权书识别及比对
说明:授权书识别及比对返回结果包含两部分:ocr 为授权委托书结构化识别结果数组,每个对象对应一份文件;compare 为多份授权委托书之间的关键字段一致性比对结果。当存在两份有效识别结果时,可返回 compare 对象,用于判断委托单位、经办人、身份证号、手机号、办理事项等字段是否一致。支持传入1-2个PDF文件。
| 字段名 |
类型 |
说明 |
示例 |
| ocr |
array |
授权委托书识别结果数组,每项对应一份授权委托书文件 |
- |
| +company |
string |
委托单位名称 |
示例科技有限公司 |
| +handler |
string |
经办人姓名 |
张某某 |
| +id |
string |
经办人身份证号,可能为完整号码或脱敏号码 |
110101********1234 |
| +mobile |
string |
经办人手机号码,可能为完整手机号或脱敏手机号 |
138****5678 |
| +entrustedItems |
array |
具体负责办理事项,可返回多个事项编码 |
["1","2","3","4"] |
| +stamp |
array |
印章识别结果数组;每个对象表示识别到的一个印章;如未识别到印章,返回空数组 |
- |
| ++type |
string |
印章类型;可选值包括 公章、个人章、专用章、其他、合同专用章、财务专用章、发票专用章、业务专用章 |
公章 |
| ++content |
string |
印章上的主体名称或可见文本内容 |
示例科技有限公司 |
| ++isCompany |
boolean |
印章内容中是否包含委托单位名称 |
true |
| +signature |
array |
手写签名识别结果数组;每个对象表示识别到的一个手写签名;如未识别到签名,返回空数组 |
- |
| ++name |
string |
手写签名姓名 |
孙xx |
| ++isHandler |
boolean |
手写签名姓名是否与经办人姓名一致 |
false |
| +file_name |
string |
当前识别结果对应的原始文件名 |
授权委托书示例1.pdf |
| compare |
object |
多份授权委托书之间的字段一致性比对结果;当存在两份有效识别结果时返回 |
- |
| +company |
string |
委托单位名称比对结果,返回 一致 或 不一致 |
一致 |
| +handler |
string |
经办人姓名比对结果,返回 一致 或 不一致 |
一致 |
| +id |
string |
身份证号比对结果,返回 一致 或 不一致 |
一致 |
| +mobile |
string |
手机号码比对结果,返回 一致 或 不一致 |
一致 |
| +entrustedItems |
string |
具体负责办理事项比对结果,返回 一致 或 不一致 |
一致 |
# 可信身份证明二要素
说明:可信身份证明二要素用于提取姓名和身份证号信息。字段内容可能存在脱敏展示,若原文为脱敏内容,则按页面显示结果返回。
| 字段名 |
类型 |
说明 |
示例 |
| 姓名 |
string |
可信身份证明中显示的姓名,可能为完整姓名或脱敏姓名 |
*可 |
| 身份证号 |
string |
可信身份证明中显示的身份证号码,可能为完整号码或脱敏号码 |
110***********3785 |
# 人像视觉分析
| 字段名 |
类型 |
中文说明 |
示例 |
| scene_type |
Integer |
场景类型:0=空/不适用,1=室内,2=室外 |
1 |
| indoor_decoration_level |
Integer |
装修程度:0=空/不适用,1=无装修,2=简易装修,3=一般装修,4=精致装修,5=无法判断 |
3 |
| indoor_decoration_style |
Integer |
装修风格:0=空/不适用,1=无装修,2=极简简陋,3=传统乡村民居,4=基础现代风,5=经济型简约风,6=中档现代风,7=工业风,8=北欧风,9=美式风格,10=轻奢风,11=豪华奢华风,12=混搭杂糅风 |
6 |
| indoor_wall_type |
Integer |
墙体类型:0=空/不适用,1=木板,2=木条,3=竹编墙,4=棕榈墙,5=混凝土,6=砖墙裸露,7=铁皮,8=PVC板墙,9=瓷砖,10=无,11=其他 |
9 |
| indoor_roof_type |
Integer |
屋顶类型:0=空/不适用,1=木板,2=竹编,3=石材,4=铁皮,5=水泥,6=波纹板,7=毛坯水泥,8=单色粉刷,9=装修吊顶,10=瓦片,11=茅草,12=无,13=其他 |
9 |
| indoor_curtain |
Integer |
窗帘:0=空/不适用,1=有,2=无 |
1 |
| indoor_curtain_color |
Integer |
窗帘颜色:0=空/不适用,1=白色,2=灰色,3=黑色,4=卡其,5=黄色,6=橙色,7=粉色,8=红色,9=蓝色,10=绿色,11=紫色,12=拼色,13=印花彩色,14=渐变色彩 |
2 |
| indoor_curtain_type |
Integer |
窗帘类型:0=空/不适用,1=简易布帘,2=纱帘,3=百叶帘,4=卷帘,5=罗马帘,6=垂直帘,7=竹帘,8=天棚帘,9=其他 |
1 |
| indoor_cleanliness |
Integer |
室内整洁度:0=空/不适用,1=整洁,2=一般,3=杂乱 |
2 |
| indoor_clean_level |
Integer |
室内干净度:0=空/不适用,1=干净,2=一般,3=脏污 |
2 |
| indoor_clothes_storage |
Integer |
衣服收纳:0=空/不适用,1=无衣物,2=随意堆放,3=随意悬挂,4=整齐收纳 |
4 |
| indoor_item_storage |
Integer |
物品收纳:0=空/不适用,1=整洁有序,2=轻度杂乱,3=重度凌乱,4=无物品 |
1 |
| indoor_random_hanging_clothes |
Integer |
随意悬挂衣服:0=空/不适用,1=是,2=否 |
2 |
| indoor_cooling_appliance |
Integer |
制冷家电:0=空/不适用,1=无,2=壁挂扇,3=落地扇,4=台扇,5=吊扇,6=壁挂空调,7=立式空调,8=中央空调,9=其他 |
6 |
| indoor_power_socket |
Integer |
电源插座:0=空/不适用,1=有,2=无 |
1 |
| indoor_socket_type |
Integer |
插座类型:0=空/不适用,1=嵌入式插座,2=明装插座,3=移动插排 |
1 |
| indoor_room_count |
Integer |
出现房间数:0=空/不适用,1=单间,2=多间,3=角落区域 |
1 |
| indoor_room_type |
Integer |
房间类型:0=空/不适用,1=卧室,2=客厅,3=厨房,4=卫生间,5=工人宿舍,6=杂货店,7=办公室,8=仓库,9=简易木棚,10=简易铁皮棚,11=病房,12=杂物间,13=商场内,14=工厂,15=其他 |
1 |
| indoor_shop_type |
Integer |
商店类型:0=空/不适用,1=厨房用品,2=小零食,3=生活用品,4=电器,5=洗漱用品,6=综合商品,7=其他 |
0 |
| indoor_room_size |
Integer |
房间大小:0=空/不适用,1=狭小,2=适中,3=宽敞,4=无法判断 |
2 |
| indoor_furniture_level |
Integer |
家具配置:0=空/不适用,1=无家具,2=廉价家具,3=中等家具,4=高档家具,5=无法判断 |
3 |
| other_person |
Integer |
第三人/其他人员出现:0=空/不适用,1=无,2=有 |
1 |
| outdoor_scene_type |
Integer |
室外类型:0=空/不适用,1=城市街道,2=城市广场,3=城市商场周边,4=城市小区,5=乡村街道,6=乡村庭院,7=乡村田间,8=露天加工厂,9=简易生产车间,10=车内,11=公园,12=其他 |
0 |
| lighting |
Integer |
光照度:0=空/不适用,1=明亮,2=正常,3=昏暗,4=黑暗 |
2 |
| urban_rural_type |
Integer |
城乡属性:0=空/不适用,1=大城市,2=小城市,3=县城,4=城郊,5=一般农村,6=贫困农村,7=山区,8=无法判断 |
1 |
| gender |
Integer |
性别:0=空/不适用,1=男,2=女,3=无法判断 |
1 |
| age_range |
Integer |
年龄区间:0=空/不适用,1=1-10岁,2=11-17岁,3=18-25岁,4=26-35岁,5=36-45岁,6=46-55岁,7=55岁以上 |
4 |
| head_wear |
Integer |
头部佩戴:0=空/不适用,1=无,2=安全帽,3=骑行头盔,4=头巾,5=浴帽,6=棒球帽,7=贝雷帽,8=礼帽,9=针织帽,10=草帽,11=医用绷带,12=其他物品 |
1 |
| neck_wear |
Integer |
颈部佩戴:0=空/不适用,1=无,2=项链,3=工牌,4=丝巾/围巾,5=颈托/医用绷带,6=耳机 |
1 |
| ear_wear |
Integer |
耳部佩戴:0=空/不适用,1=无,2=耳钉,3=耳环 |
1 |
| glasses |
Integer |
眼镜:0=空/不适用,1=无,2=透明眼镜,3=深色眼镜 |
2 |
| face_appearance |
Integer |
脸部容貌:0=空/不适用,1=正常,2=普通瑕疵,3=部分疤痕或创伤,4=大面积疤痕,5=毁容,6=畸形 |
1 |
| facial_expression |
Integer |
表情:0=空/不适用,1=正常,2=挤眉弄眼,3=扮鬼脸,4=怪笑,5=夸张表情 |
1 |
| facial_decoration |
Integer |
面部装饰:0=空/不适用,1=贴胶布,2=夸张涂抹,3=特殊符号,4=道具装饰,5=面膜,6=无,7=其他装饰 |
6 |
| beard_exist |
Integer |
是否有胡须:0=空/不适用,1=是,2=否 |
2 |
| beard_type |
Integer |
胡须类型:0=空/不适用,1=无胡须,2=胡茬,3=一字胡,4=八字胡,5=山羊胡,6=络腮胡,7=长款络腮胡,8=龙须胡,9=武士胡,10=其他胡须 |
1 |
| face_shape |
Integer |
脸型:0=空/不适用,1=圆形脸,2=椭圆形脸,3=方形脸,4=长形脸,5=心形脸,6=三角形脸,7=倒三角形脸,8=菱形脸,9=其他 |
2 |
| eyebrow_type |
Integer |
眉毛:0=空/不适用,1=一字眉,2=柳叶眉,3=野生眉,4=剑眉,5=弯眉,6=挑眉,7=平眉,8=断眉,9=无眉,10=稀疏眉,11=浓密眉,12=其他眉毛 |
11 |
| eye_open_close |
Integer |
眼睛开闭:0=空/不适用,1=睁大眼睛,2=自然睁眼,3=半睁眼,4=闭眼,5=眯眼 |
2 |
| eye_gaze |
Integer |
视线方向:0=空/不适用,1=斜视,2=正视,3=俯视,4=仰视 |
2 |
| nose_type |
Integer |
鼻子:0=空/不适用,1=高鼻梁,2=塌鼻梁,3=鹰钩鼻,4=朝天鼻,5=蒜头鼻,6=直鼻,7=翘鼻,8=宽鼻,9=窄鼻,10=驼峰鼻,11=其他鼻型 |
6 |
| mouth_type |
Integer |
嘴巴:0=空/不适用,1=M唇,2=花瓣唇,3=嘟嘟唇,4=薄唇,5=厚唇,6=樱桃唇,7=香肠唇,8=均衡唇,9=扬角唇,10=垂角唇,11=其他嘴型 |
8 |
| face_fatness |
Integer |
脸庞胖瘦:0=空/不适用,1=极瘦,2=较瘦,3=正常,4=较胖,5=极胖 |
3 |
| face_attractiveness |
Integer |
颜值:0=空/不适用,1=非常丑,2=较丑,3=一般,4=漂亮,5=非常漂亮 |
3 |
| upper_cloth_type |
Integer |
上衣款式:0=空/不适用,1=未穿上衣,2=内衣类,3=小吊带与背心,4=T恤,5=短袖衬衫,6=长袖衬衫,7=卫衣与连帽衫,8=针织上衣,9=夹克与外套,10=工服,11=制服,12=马甲,13=民族或特殊上衣,14=其他 |
4 |
| upper_cloth_material |
Integer |
上衣材质:0=空/不适用,1=棉麻,2=化纤,3=毛呢,4=丝绸,5=丝绒,6=针织,7=皮革,8=牛仔面料,9=功能面料,10=其他 |
1 |
| uniform_type |
Integer |
制服类型:0=空/不适用,1=保安,2=警察或军人,3=医护人员,4=外卖与快递,5=清洁与后勤,6=工程与工地,7=工厂与制造,8=餐饮服务,9=零售与商超,10=教育制服,11=交通运输,12=银行与政府机构制服,13=酒店服务,14=宗教制服,15=其他 |
0 |
| clothing_scene_style |
Integer |
场景衣着风格:0=空/不适用,1=休闲服,2=居家服,3=制服,4=正装,5=运动服,6=性感服装 |
1 |
| clothing_fit |
Integer |
衣着宽松度:0=空/不适用,1=宽松,2=正常,3=紧身 |
2 |
| clothing_cleanliness |
Integer |
衣着干净度:0=空/不适用,1=洁净,2=轻度污渍,3=重度脏污 |
1 |
| clothing_color_mix |
Integer |
配色:0=空/不适用,1=单色,2=双色,3=复杂多色 |
1 |
| upper_body_exposure |
Integer |
上身裸露程度:0=空/不适用,1=未裸露,2=小面积裸露,3=大面积裸露,4=全部裸露 |
1 |
| tattoo_exists |
Integer |
是否纹身:0=空/不适用,1=是,2=否 |
2 |
| tattoo_area |
Integer |
纹身面积:0=空/不适用,1=小,2=中,3=大 |
0 |
| tattoo_type |
Integer |
纹身类型:0=空/不适用,1=几何抽象,2=自然生物,3=文字符号,4=传统民俗,5=卡通潮流,6=暗黑神秘,7=其他 |
0 |
| tattoo_position |
Integer |
纹身位置:0=空/不适用,1=颈部,2=胳膊,3=胸部,4=背部,5=头部,6=面部,7=其他 |
0 |
| hair_color |
Integer |
头发颜色:0=空/不适用,1=白发,2=红色,3=绿色,4=紫色,5=灰色,6=黄色,7=黑色,8=金色,9=其他 |
7 |
| hair_neatness |
Integer |
头发整齐度:0=空/不适用,1=自然,2=凌乱,3=精致 |
1 |
| hair_style_type |
Integer |
发型类型:0=空/不适用,1=秃头/含地中海,2=超短发,3=短发,4=中短发/齐耳,5=中发/齐肩,6=中长发/及胸,7=长发/及腰,8=超长发/腰以下,9=特殊结构发型,10=其他 |
3 |
| hair_volume |
Integer |
发量:0=空/不适用,1=额头秃,2=全秃,3=稀疏,4=正常 |
4 |
| wig_wear |
Integer |
是否戴假发:0=空/不适用,1=是,2=否 |
2 |
| hair_glossiness |
Integer |
光泽度:0=空/不适用,1=高光泽,2=自然光泽,3=无光泽 |
2 |
| body_shape |
Integer |
身材:0=空/不适用,1=极瘦,2=较瘦,3=正常,4=较胖,5=极胖 |
3 |
| holding_card |
Integer |
是否手持卡证:0=空/不适用,1=是,2=否 |
2 |
| communication_device |
Integer |
通讯娱乐设备:0=空/不适用,1=无,2=固话,3=手机,4=头戴式耳机,5=入耳式无线耳机,6=入耳式有线耳机 |
3 |
| pose_type |
Integer |
姿势:0=空/不适用,1=站立,2=倚靠,3=坐立,4=蹲着,5=仰卧,6=侧卧 |
1 |
# 印章识别及截图裁剪字段说明
说明:用于印章检测与结构化提取,返回结构:数组 []。当前仅支持单个印章的识别,识别结果包含印章类型、内容、图像区域及裁剪结果。
| 字段名 |
类型 |
中文说明 |
示例 |
| type |
string |
印章类型枚举 |
公章 / 合同专用章 / 财务专用章 / 发票专用章 / 业务专用章 / 其他专用章 / 个人章 / 其他 |
| content |
string |
印章文字内容(主体名称或可见文本) |
XX有限公司 |
| base64 |
string |
印章原始截取图像(base64编码) |
/9j/4AAQSkZJRg... |
| bbox |
array[number] |
印章检测框坐标 [x_min, y_min, x_max, y_max](像素坐标) |
[11.25, 14.56, 139.99, 136.62] |
| cropped_base64 |
string |
基于 bbox 精修裁剪后的印章图(贴边优化) |
/9j/4AAQSkZJRg... |
# 成功状态码
HTTP 状态码 status_code=200代表接口调用成功,返回值中pages不为空时计费/扣除试用次数。
# 错误信息
|
错误信息 |
说明 |
| 400 |
BAD_ARGUMENTS: <key> |
某个参数解析出错(比如必须是数字,但是输入的是非数字字符串;或者长度过长,或者照片无法解析) |
| 400 |
MISSING_ARGUMENTS: <key> |
缺少某个必选参数 |
| 400 |
KEY_NOT_FOUND |
encryption_type 开启加密,但未配置加密公钥和解密私钥 |
| 403 |
AUTHENTICATION_ERROR |
api_key 和 api_secret 不匹配 |
| 400 |
FILE_PARSE_FAILED:<reason> |
文件下载处理环节异常 |
| 400 |
FILE_EXTRACT_FAILED:<reason> |
文件识别环节异常 |
| 400 |
INVALID_INPUTS_PARAM:<reason> |
自定义参数 inputs 格式不符 |
| 400 |
FILE_TOO_LARGE |
文件超过允许的大小限制(10M) |
| 400 |
FILE_UNSUPPORTED_FORMAT |
文件格式错误 |
| 400 |
TOO_MANY_FILES |
上传文件数量超过了限制 |
| 403 |
CONCURRENCY_LIMIT_EXCEEDED |
并发数超过限制 |
| 404 |
API_NOT_FOUND |
所调用的 API 不存在 |
| 413 |
Request Entity Too Large |
客户发送的请求大小或单张照片大小超过了 10MB。 |
| 500 |
INTERNAL_ERROR |
服务器内部错误,当此类错误发生时请再次请求,如果持续出现此类错误,请及时联系客服或商务 |