回声笔AI论文降重API接口文档 - 请求响应说明

回声笔AI论文降重API接口文档，包含请求参数、响应格式、HTTP状态码说明，支持知网、维普、格子达等检测平台降重降AI。

论文降重/降AI接口 v 2.0

2026-03-26，2.1更新，现在模型拥有了良好的书面表达，提升了改写质量。v 1.30不再维护，在2026年12月31日后将停止服务。

该服务属于段落级别的改写，并不支持长文改写，接口支持1000字以内文本。建议您逐个段落调用降重降AI接口。强烈建议：按段落传入接口进行改写，不建议把提纲、目录、参考文献、公式以及代码一起传入，会影响改写结果。

1. 接口地址

POST https://api.llmapi.fit/completion/v2/reduce

2. 认证方式

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

3. 请求参数

参数名	类型	必填	说明
`text`	string	是	需要改写的文本内容（最多1000字）
`service_type`	string	否	系统已内置为`mix`，无需指定

接口默认同时完成降重和降AI，service_type是v 1.30版本用的参数，此处为了兼容，故依然保留该参数，无需传入。

4. 请求示例

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "text": "高村乡农村集体经济发展的重要因素是带头人的能力水平..."
  }' \
  "https://api.llmapi.fit/completion/v2/reduce"

5. 响应示例

与v 1.30的响应结构完全一样

{
  "code": "success",
  "message": "",
  "request_id": "a1b2c3d4e5f6789012345678",
  "output_text": "高村乡农村集体经济发展重要的是带头人能力强...",
  "input_text_count": 169
}

6. 错误码说明

HTTP 200 表示改写成功，返回JSON包含"code": "success"。
非200状态码表示请求失败，响应体中包含 code 字段标识具体错误类型。

6.1 code与message对照表

HTTP状态码	code	message	处理建议
400	`textEmpty`	文本内容为空	检查 `text` 字段是否为空
400	`textTooLong`	文本超过字数限制	不超过1000字
400	`useageLimitedFailed`	可用字数不足	提醒用户充值
400	`badRequest`	请求参数错误	检查请求参数格式
401	`unauthorized`	API密钥无效或已禁用	检查API密钥是否正确
429	`rateLimited`	请求过于频繁	降低请求频率，等待后重试
500	`internalFailed`	服务器内部错误	稍后重试，如持续出现请联系技术支持
503	`noGpuAvailable`	GPU服务繁忙	等待3-5秒后重试
503	`serviceUnavailable`	服务暂时不可用	稍后重试

6.2 错误响应格式

所有错误响应均包含 code 和 message 字段：

{
  "code": "错误码",
  "message": "错误描述信息"
}

6.3 常见错误示例

// 余额不足
{
  "code": "useageLimitedFailed",
  "message": "可用字数不足"
}

// 文本超限
{
  "code": "textTooLong",
  "message": "文本字数超过1000字上限"
}

// GPU服务繁忙
{
  "code": "noGpuAvailable",
  "message": "GPU服务繁忙，请稍后重试"
}

// 请求过于频繁
{
  "code": "rateLimited",
  "message": "请求过于频繁，请稍后重试"
}

7. 注意事项

文本长度：建议不超过1000字
请求速率：建议控制在10次/秒以内
字数统计：按Word统计方式，非字符数
失败扣费：请求错误时字数会自动退回

8. 获取帮助

📧 微信：GDDMDD
🔧 提供 request_id 便于问题排查