NLP 中文智能纠错

识别中文文本中的常见错误，返回完整纠正文本和可定位的修改明细。
接口特性：

提供保守、标准和增强三种纠错强度；

可尽量保留原文语气、格式与表达风格；

逐项返回原词、建议修改内容及字符位置；

单次支持最长 4000 字符的中文文本；

纠错结果建议结合具体语境进行人工复核。
详情页：https://www.gugudata.com/api/details/nlpcorrect

当前接口契约

接口详情：https://www.gugudata.com/api/details/nlpcorrect

功能说明

识别常见错别字、用词与语法表达问题；

返回完整纠正文本，便于直接展示或保存；

逐项返回原词与建议修改内容；

标注每处修改在原文中的字符位置；

支持最长 4000 字符的中文文本处理；

适合文章、公告、客服回复和运营文案检查；

可用于内容发布前质检与文本录入校对；

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	购买接口后获取的调用凭证。请仅在服务端安全保存，不要写入公开代码或客户端日志。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
content	string	是	无	待纠错文本，最长 4000 个字符。
correctionMode	string	否	standard	可选 conservative、standard、aggressive。
preserveStyle	boolean	否	true	是否尽量保留原文风格。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	业务状态码，100 表示成功。
DataStatus.StatusDescription	string	业务状态说明。
DataStatus.ResponseDateTime	string	服务端响应时间。
DataStatus.DataTotalCount	integer	成功时为 1，错误时为 0。
Data.CorrectedContent	string	纠正后的完整文本。
Data.Corrects	array	纠正操作数组，无修改时为空数组。
Data.Corrects[].SourceWord	string	原文片段。
Data.Corrects[].CorrectedWord	string	纠正后的片段。
Data.Corrects[].StartIndex	integer	原文 UTF-16 起始索引，从 0 开始。
Data.Corrects[].EndIndex	integer	原文 UTF-16 结束索引，不包含该位置。

业务状态说明

业务状态码	业务状态码解释	备注
100	正常返回	请求成功。
501	参数错误	请按文档检查参数格式和取值范围。
502	请求频率受限	请按套餐 QPS 控制调用频率。
503	账号欠费	请检查账户状态。
504	APPKEY 错误	请检查 APPKEY 和接口购买状态。
505	请求次数超出接口限制	请检查剩余配额。
900	接口内部响应错误	接口服务暂时不可用，请稍后重试。
901	服务暂时不可用	当前没有可用数据或服务暂时异常，请稍后重试。

常见问题

正式接口怎么提交待纠错文本？

向 /text/correct 发送 POST 请求，Content-Type 使用 application/json。在 JSON 正文的 content 字段填写非空中文文本，并提供该接口的 AppKey。可选的 correctionMode 和 preserveStyle 也放在 JSON 正文中。

一次能提交多长的文本？长文怎么处理？

content 单次最多 4000 个 UTF-16 代码单元，常用汉字通常每个占 1 个。长文可按自然段或句子切分后分别提交，再按原顺序合并每段的 CorrectedContent。需要在全文中高亮修改时，把每段的起始偏移加到该段的纠错索引上。

三种纠错模式怎么选？怎样保留原文风格？

conservative 偏向只修改明确错误，standard 默认纠正常见错误，aggressive 还可调整明显不通顺的表达。preserveStyle 默认为 true，表示尽量保留原文语气、标点和写作风格。需要显式设置时，请传 JSON 布尔值 true 或 false。

怎么根据返回结果在原文里标出修改？

Data.CorrectedContent 是纠正后的完整文本，Data.Corrects 列出每处修改。每条的 StartIndex 和 EndIndex 都相对于传入的原文，按 UTF-16 从 0 开始，包含起点、不包含终点。SourceWord 是该区间的原文，CorrectedWord 是替换文本。若用这些操作重建全文，可从后往前替换，避免前一处修改影响后续索引。

怎么区分无需纠错和请求失败？

先看 DataStatus.StatusCode。等于 100 且 Data.Corrects 为空数组时，本次未给出修改，Data.CorrectedContent 与原文一致。其他业务状态请结合 HTTP 状态和 DataStatus.StatusDescription 排查。

Demo 和正式接口有什么区别？

Demo 无需 AppKey，供接口请求测试和开发调试使用。它对固定样例执行纠错，返回与正式接口一致的成功数据结构，包括完整纠错文本和修改明细。正式接口需使用对应的 AppKey，可提交自己的文本并选择纠错模式。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求成功，业务码 100。

Bodyapplication/json

示例

{
  "DataStatus": {
    "StatusCode": 0,
    "StatusDescription": "string",
    "ResponseDateTime": "string",
    "DataTotalCount": 0
  },
  "Data": {
    "CorrectedContent": "string",
    "Corrects": [
      {}
    ]
  }
}

🟠400参数错误，业务码 501。

🟠401缺少或无效 APPKEY，业务码 504。

🟠403订单过期或额度不可用，业务码 503 或 505。

🟠429请求频率受限，业务码 502。

🔴500服务内部错误，业务码 900。

🔴503纠错服务暂时不可用，业务码 901。

当前接口契约#

功能说明#

请求参数#

正常响应字段#

业务状态说明#

常见问题#

正式接口怎么提交待纠错文本？#

一次能提交多长的文本？长文怎么处理？#

三种纠错模式怎么选？怎样保留原文风格？#

怎么根据返回结果在原文里标出修改？#

怎么区分无需纠错和请求失败？#

Demo 和正式接口有什么区别？#

请求参数

请求示例代码

返回响应

当前接口契约

功能说明

请求参数

正常响应字段

业务状态说明

常见问题

正式接口怎么提交待纠错文本？

一次能提交多长的文本？长文怎么处理？

三种纠错模式怎么选？怎样保留原文风格？

怎么根据返回结果在原文里标出修改？

怎么区分无需纠错和请求失败？

Demo 和正式接口有什么区别？