API 文档
接口地址: https://api.gugudata.com/imagerecognition/ocr
返回格式: application/json; charset=utf-8
请求方式: POST
请求协议: HTTPS
请求示例: https://api.gugudata.com/imagerecognition/ocr?appkey=YOUR_APPKEY
数据预览: https://www.gugudata.com/preview/ocr
接口测试: https://api.gugudata.com/imagerecognition/ocr/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数(POST 请求参数以 application/x-www-form-urlencoded 格式、文件流以 formdata 格式传递,具体可参见下方示例代码)
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
支持既有 Query、Body、Header 和 Bearer 鉴权。 |
| imageurl |
string |
否 |
无 |
公开 HTTP/HTTPS 图片地址;与 imagebase64 至少提供一项,同时提供时 URL 优先。 |
| imagebase64 |
string |
否 |
无 |
图片 Base64 字符串;未提供 imageurl 时使用。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
实际业务请求参数,不包含凭据。 |
| DataStatus.StatusCode |
integer |
成功为100;参数错误501,处理或依赖失败901。 |
| DataStatus.StatusDescription |
string |
请求结果说明。 |
| DataStatus.ResponseDateTime |
string |
响应时间。 |
| DataStatus.DataTotalCount |
integer |
成功为1;文本行数以ResultText数组长度为准。 |
| Data.SourceImageUrl |
string |
URL模式为输入图片地址;Base64模式为BASE64。 |
| Data.ResultText |
array |
按识别后的文字行返回字符串数组;成功无文字时为空数组。 |
仅展示部分示例数据,数组最多展示 3 项,长内容已省略;完整数据请调用接口获取。
{
"DataStatus": {
"RequestParameter": "{\"imageurl\":\"https://static.gugudata.com/demo/ocr/v1/input-8938953a7fc0576fb1de.png\"}",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-10-22 17:35:20.375",
"DataTotalCount": 1
},
"Data": {
"SourceImageUrl": "https://static.gugudata.com/demo/ocr/v1/input-8938953a7fc0576fb1de.png",
"ResultText": [
"咕咕数据OCR样例",
"GuGuData image recognition sample 日期:2026-10-22 编号:1024",
"项目Item\t数量Count\t金额Amount"
]
}
}