图片 OCR 转 Word

将 JPEG、PNG、GIF、BMP 或 TIFF 图片转换为可编辑的 DOCX 文档，支持图片 URL 和 Base64 二选一输入。

接口详情：https://www.gugudata.com/api/details/ocr2word
请求方法：POST
接口路径：/imagerecognition/ocr2word
调试地址：https://api.gugudata.com/imagerecognition/ocr2word/demo
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

鉴权：

推荐通过 X-GUGUDATA-APPKEY 请求头传入 APPKEY。

为兼容既有接入，也可继续使用请求体 appkey 参数。

请求参数：

imageurl（可选）：公开可访问的 HTTPS 图片地址，与 imagebase64 必须且只能提供一个。

imagebase64（可选）：图片 Base64 或 Data URI，与 imageurl 必须且只能提供一个。

language（可选）：auto、zh-cn、zh-tw、en、ja、ko、fr、de，默认 auto。

storage（可选）：public 或 private，默认 public；敏感材料建议使用 private。

fileName（可选）：输出文件名，最长 80 个字符，文件格式固定为 DOCX。

返回结果包含存储模式、文件名、文件类型、文件大小、语言、处理耗时、请求标识和生成时间。public 模式返回 ResultWordFileUrl；private 模式返回 FileId，可用于申请短期下载地址。

单张图片最大 20 MB。识别效果受图片清晰度、字体和排版影响，关键内容建议复核。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "input=url&storage=public&language=auto",
    "StatusCode": 100,
    "StatusDescription": "生成成功",
    "ResponseDateTime": "2026-08-10 18:21:32.300",
    "DataTotalCount": 1
  },
  "Data": {
    "SourceImageUrl": "https://static.gugudata.com/ocr_demo_image_52.jpg",
    "ResultWordFileUrl": "https://cdn.gugudata.com/word/2026/08/10/a91eea7e0d1645cc8218d8455943e2f3.docx",
    "Storage": "public",
    "FileId": null,
    "FileName": "ocr-result.docx",
    "ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
    "FileSize": 7857,
    "Language": "auto",
    "ProcessingTimeMs": 10709,
    "RequestId": "a91eea7e0d1645cc8218d8455943e2f3",
    "GeneratedAt": "2026-08-10T10:21:32.1595948Z"
  }
}