# 通用文件流 OCR 到文本 API 接口


通用文件流 OCR 到文本 API 接口

通用文件流识别接口，基于机器学习，精准识别率。

![gugudata_api_cover](https://static.gugudata.com/api_streamocr_v3.png)

# 1. 产品功能

- 通用的识别接口， 支持多种图片格式；
- 支持中英文字符混合识别；
- formdata 格式的图片文件流传参；
- 基于机器学习不断提高的识别率；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡。

# 2. API 文档

**API 详情地址:** [https://www.gugudata.com/api/details/imagestreamocr](https://www.gugudata.com/api/details/imagestreamocr)

**接口请求地址:** [https://api.gugudata.com/imagerecognition/imagestreamocr?appkey={{appkey}}](https://api.gugudata.com/imagerecognition/imagestreamocr?appkey={{appkey}})

**返回格式:** application/json; charset=utf-8

**请求方式:** POST

**请求协议:** HTTPS

**数据预览:** [https://www.gugudata.com/preview/imagestreamocr](https://www.gugudata.com/preview/imagestreamocr)

**请求示例:** [https://api.gugudata.com/imagerecognition/imagestreamocr?appkey={{appkey}}](https://api.gugudata.com/imagerecognition/imagestreamocr?appkey={{appkey}})

**接口测试:** [https://api.gugudata.com//imagerecognition/imagestreamocr/demo](https://api.gugudata.com//imagerecognition/imagestreamocr/demo)

# 3. 请求参数

|  参数名   | 参数类型 | 是否必须 |   默认值   |      备注       |
| :-------: | :------: | :------: | :--------: | :-------------: |
| imagefile |   file   |    是    | YOUR_VALUE | formdata 文件流 |

# 4. 返回参数

|            参数名            | 参数类型 |                           备注                           |
| :--------------------------: | :------: | :------------------------------------------------------: |
|    DataStatus.StatusCode     |   int    |                      接口返回状态码                      |
| DataStatus.StatusDescription |  string  |                     接口返回状态说明                     |
| DataStatus.ResponseDateTime  |  string  |                     接口数据返回时间                     |
|  DataStatus.DataTotalCount   |   int    |           此条件下的总数据量，一般用于分页计算           |
|       Data.ResultText        | string[] | 识别出的文本数组，识别后的每一行文字对应数组的每一个元素 |