图片 OCR 转 Word

POST

https://api.gugudata.com/imagerecognition/ocr2word

图像/转换

将图片中的文字和基础版式转换为可编辑的 Word 文档。支持 HTTPS 图片地址或 Base64 图片二选一传入，支持 JPEG、PNG、GIF、BMP、TIFF，单张图片最大 20 MB、最长边最大 12000 像素且总像素不超过 4000 万。可选指定识别语言、输出文件名以及公开或私有存储；合同、票据等敏感材料建议使用 private。识别效果受图片清晰度、字体、排版和语言影响，调用方应对关键内容进行复核。
详情页：https://www.gugudata.com/api/details/ocr2word

请求参数

Authorization

API Key

在 header 添加参数

X-GUGUDATA-APPKEY

示例：

X-GUGUDATA-APPKEY: ********************

API Key

在 query 添加参数

appkey

示例：

appkey: ********************

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数application/x-www-form-urlencoded必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff 'https://api.gugudata.com/imagerecognition/ocr2word?appkey=请前往 https://www.gugudata.com 购买' \
--header 'X-GUGUDATA-APPKEY: <api-key>' \
--data-urlencode 'appkey=' \
--data-urlencode 'imageurl=https://static.gugudata.com/ocr_demo_image_52.jpg' \
--data-urlencode 'imagebase64=' \
--data-urlencode 'language=zh-cn' \
--data-urlencode 'storage=private' \
--data-urlencode 'fileName=识别结果.docx'

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "DataStatus": {
        "StatusCode": 0,
        "StatusDescription": "string",
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": null
    },
    "Data": {
        "SourceImageUrl": "string",
        "ResultWordFileUrl": "http://example.com",
        "Storage": "public",
        "FileId": "string",
        "FileName": "string",
        "ContentType": "string",
        "FileSize": 1,
        "Language": "string",
        "ProcessingTimeMs": 0,
        "RequestId": "string",
        "GeneratedAt": "2019-08-24T14:15:22.123Z"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

修改于 2026-08-17 10:16:54

Markdown 转 PDF

PDF 解析格式化输出