适用场景出租车发票识别 API 核心价值是将机打发票上的结构化信息车号、金额、里程等转化为 JSON 数据直接用于以下场景差旅费报销自动录入员工拍照上传发票系统自动提取金额、日期、车号免去手工输入。行程费用核对财务或行政部门批量核对出租车发票与实际报销金额是否一致。审计与合规检查提取发票代码、号码、印章信息验证发票真伪或归属。该 API 仅识别全国出租车机打发票手撕发票、收据等不在支持范围内。图片要求拍摄平整、清晰避免反光、折叠或角度倾斜过大。接口能力边界维度说明支持输入方式URL 或 base64 编码返回字段数16 个详见返回值部分最大并发 QPS2 / s图片建议尺寸长边不低于 500px分辨率 ≥ 72dpi单次请求最大图片体积以平台文档为准建议小于 5MB接口不会对图片进行裁剪或预处理若发票区域占比过小识别准确率可能下降。鉴权与请求参数鉴权方式使用 HTTP Header 携带 API Key素材给出了两种写法本文以X-API-Key为例可兼容Authorization: Bearer key的方式具体以平台最新文档为准。X-API-Key: YOUR_API_KEY请求体参数请求体为 JSON 对象包含两个必填字段参数名类型必填描述input_typestring是图片传输方式url公网图片链接或base64图片的 base64 编码input_datastring是当input_typeurl时填完整图片链接当input_typebase64时填 base64 字符串可含data:image/xxx;base64,前缀示例URL 方式{ input_type: url, input_data: https://example.com/taxi-invoice.jpg }curl 最小可运行示例以下命令可直接复制后在终端运行注意将YOUR_API_KEY替换为实际值并将图片链接换成自己的发票图片curl -sS \ -X POST \ -H X-API-Key: YOUR_API_KEY \ -H Content-Type: application/json \ -d {input_type: url, input_data: https://example.com/taxi-invoice.jpg} \ https://v1.apizero.cn/api/ocr-taxi-invoice若使用 base64 方式可将input_data替换为编码字符串data$(base64 -w0 /path/to/taxi-invoice.jpg) curl -sS -X POST \ -H X-API-Key: YOUR_API_KEY \ -H Content-Type: application/json \ -d {\input_type\:\base64\,\input_data\:\$data\} \ https://v1.apizero.cn/api/ocr-taxi-invoice注意base64 编码时不要添加换行建议使用base64 -w0Linux/macOS或tr -d \n处理后传入。Python 接入示例对于后端开发者使用requests库更为方便import requests import base64 API_URL https://v1.apizero.cn/api/ocr-taxi-invoice API_KEY YOUR_API_KEY # 方式一URL def recognize_by_url(image_url): payload { input_type: url, input_data: image_url } headers { X-API-Key: API_KEY, Content-Type: application/json } resp requests.post(API_URL, jsonpayload, headersheaders) return resp.json() # 方式二base64 def recognize_by_base64(image_path): with open(image_path, rb) as f: b64_str base64.b64encode(f.read()).decode(utf-8) payload { input_type: base64, input_data: b64_str } headers { X-API-Key: API_KEY, Content-Type: application/json } resp requests.post(API_URL, jsonpayload, headersheaders) return resp.json() # 示例调用 result recognize_by_url(https://example.com/taxi-invoice.jpg) print(result)返回值解读成功响应 HTTP 200返回 JSON 格式顶层包含code、msg、data、request_id。当code为 0 时表示成功。data对象包含以下字段基础信息title_trial发票标题如“出租汽车发票”invoice_code发票代码12 位invoice_no发票号码8 位start_date乘车日期格式 yyyy-MM-dd车号与时间car_number出租车车牌号含省份简称如“沪A12345”start_time上车时间HH:mmend_time下车时间HH:mm费用明细distance行驶里程公里保留一位小数price单价元/公里total_amount总金额元additional_fee附加费元如燃油附加费dispatch_fee电召费元部分发票无此字段则为空字符串印章与归属invoice_special_seal发票专用章文字内容seller_name_in_seal印章中的单位名称seller_taxpayer_no_in_seal印章中的纳税人识别号is_sealed是否已盖章字符串“true”或“false”响应示例{ code: 0, msg: 成功, data: { additional_fee: 1.00, car_number: 沪A12345, dispatch_fee: , distance: 12.3, end_time: 10:05, invoice_code: 31100000000, invoice_no: 87654321, invoice_special_seal: XX出租汽车发票专用章, is_sealed: true, price: 3.00, seller_name_in_seal: XX出租汽车有限公司, seller_taxpayer_no_in_seal: 91310000XXXXXXXXXX, start_date: 2024-01-15, start_time: 09:30, title_trial: 出租汽车发票, total_amount: 38.50 }, request_id: req_abc123 }所有数值字段均为字符串类型空字段返回空字符串而非 null。常见错误与排查HTTP 状态码错误码常见原因解决方案401-API Key 错误或缺失检查X-API-Key请求头值是否正确4001001请求参数格式错误确认input_type为url或base64且input_data非空4001002图片无法访问URL 方式检查图片链接是否可公开访问或使用 base644001003base64 解码失败确保编码字符串有效不含非法字符5002000服务内部错误稍后重试若持续失败请联系技术支持若响应中code非 0可通过msg字段获取错误描述。注意平台可能返回其他错误码建议以实际响应为准。工程化注意事项1. 图片质量要求平整度发票应铺平拍摄避免褶皱或弯曲导致字符扭曲。光线均匀避免强光直射或阴影遮挡关键区域如发票代码、金额。分辨率建议发票区域在图片中占比超过 60%长边不低于 500px。格式主流格式JPEG、PNG、BMP均支持推荐 JPEG 以减少体积。2. QPS 限流处理该接口 QPS 上限为 2即每秒最多发起 2 次请求。批量场景下建议加入简单的令牌桶或固定间隔控制import time def batch_recognize(image_urls): results [] for url in image_urls: result recognize_by_url(url) results.append(result) time.sleep(0.5) # 确保不超过 2 QPS return results3. 重试策略对于 5xx 错误或网络超时建议使用指数退避重试最大 3 次即可import requests from time import sleep def recognize_with_retry(image_url, max_retries3): for attempt in range(max_retries): try: return recognize_by_url(image_url) except (requests.ConnectionError, requests.Timeout) as e: if attempt max_retries - 1: sleep(2 ** attempt) else: raise4. 字段校验与容错由于 OCR 识别的天然缺陷个别字段可能识别错误或遗漏。建议业务代码中加入空值检查和人工复核逻辑若total_amount为空可标记为“人工确认”若car_number不符合车牌号格式则触发二次校验。5. 数据存储建议提取的字段建议统一存入数据库并保留request_id用于追踪调用日志。字段类型可统一为varchar便于容纳各种格式。参考文档官方文档页https://apizero.cn/aidocs/ocr-taxi-invoice原始接口定义https://apizero.cn/aidocs/ocr-taxi-invoice/raw.md以上文档包含完整的参数说明、更新记录及联系方式。