跳到主要内容

AIGC 降重接口文档

一、接口概述​

1.1 基本信息​

  • 请求域名：https://xueshu.kuaisou.com

  • 请求地址：/v1/aigc-api/ai/doGenerate

  • 请求方法：POST

  • 认证方式：使用 Bearer Token 认证，在请求头中添加 Authorization: Bearer sk-Y********************************************A

  • 接口功能：接收用户输入文本，通过内置模型进行 AIGC 降重处理，生成更具原创性的内容。

1.2 适用场景​

适用于论文降重、文章优化、内容创作等场景，帮助用户提升文本的原创性，降低 AI 检测率。

二、请求参数​

参数名类型是否必填说明
textstring是待降重的文本内容，需保证内容合法合规
levelValuestring/array否替换档位，支持0至5档，可传入单个值或多个档位（如"1,2"或数组形式）。默认值：0
lockWordsTextstring/array否锁定关键词（冻结关键词），多个关键词以逗号分隔或数组形式传递。若未提供，将从服务器同目录下的lockword.txt文件中加载

2.1 档位说明​

档位值说明适用场景
0原文未改动用于对照或测试
1轻度改写适合论文降重
2中度改写适合自媒体内容
3深度改写适合严格降AI检测
4彻底改写适合彻底降低AI检测率
5极限改写适合要求极高的场景

三、请求示例​

3.1 Python 示例​

import requests

url = "/v1/aigc-api/ai/doGenerate"
headers = {
    "Authorization": "Bearer sk-Y********************************************A",
    "Content-Type": "application/json"
}
data = {
    "text": "待降重的原始文本内容",
    "levelValue": "1", 
    "lockWordsText": "人工智能,机器学习"  # 或使用数组形式：["人工智能", "机器学习"]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

3.2 cURL 示例​

curl -X POST "/v1/aigc-api/ai/doGenerate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-Y********************************************A" \
  -d '{
        "text": "待降重的原始文本内容",
        "levelValue": "1",
        "lockWordsText": "人工智能"
      }'

四、响应参数​

字段类型说明
dataObject主数据对象
└─ resultObject结果对象
└─ paragraph_resultObject段落结果对象
└─ paragraph_resultArray[Object]段落数组，每个元素包含 txt 字段
└─ txtString段落文本内容
└─ output_textString拼接后的完整降重文本（含所有段落内容）
└─ packageObject用户套餐信息对象
└─ order_noString订单号
└─ package_typeNumber套餐类型
└─ package_dayNumber套餐天数
└─ package_priceNumber套餐价格
└─ package_usesNumber套餐总次数
└─ remain_usesNumber剩余可用次数
└─ user_idString用户ID
└─ remaining_usesNumber当前剩余可用次数
errcodeNumber错误码，0为成功
errmsgString错误信息
request_idNull/String请求ID
traceIdString追踪ID
debugArray调试信息数组

五、响应示例​

5.1 成功响应​

{
    "data": {
        "result": {
            "paragraph_result": {
                "paragraph_result": [
                    {"txt": " 引言"},
                    {"txt": ""},
                    {"txt": "技术不息进步为咱们生活带来前所未有改变，而"升级"接近成现代生活一个根本词..."}
                    // ...更多段落
                ],
                "output_text": " 引言\n\n技术不息进步为咱们生活带来前所未有改变...（完整拼接文本）"
            },
            "package": {
                "order_no": "2506200948112630",
                "package_type": 5,
                "package_day": 1,
                "package_price": 0.01,
                "package_uses": 10,
                "remain_uses": 7,
                "user_id": "11063"
            }
        },
        "remaining_uses": 0
    },
    "errcode": 0,
    "errmsg": "请求成功",
    "request_id": null,
    "traceId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "debug": []
}

5.2 失败响应​

5.2.1 参数验证失败​

{
    "request_id": null,
    "code": 422,
    "traceId": "9723c2f14835fc836765ce0542904ddfdbb085605bbc631edea2ca1f5c51995a",
    "msg": "参数验证失败: 降重文本不能为空",
    "debug": []
}

5.2.2 服务不可用​

{
    "request_id": null,
    "code": 500,
    "traceId": "db9338b86b9f54bb6ae9f7f5394d4d4c775aed03ca7652e80f70006a48219cfc",
    "msg": "套餐不可用",
    "debug": []
}

六、错误码说明​

错误码错误信息可能原因及解决建议
0降重成功正常返回结果，解析data字段获取详细信息
401参数验证失败检查请求参数是否完整、格式正确，确保API-KEY是正确无误得
500无可用套餐请您先去官方网站购买套餐之后在调取此接口
503服务不可用服务可能处于维护中或出现临时故障，请确保您已购买套餐稍后重试；若持续不可用，联系技术支持排查问题
其他降重处理失败根据msg提示排查问题，如网络异常、服务器内部错误；可尝试重新请求或联系技术支持解决

七、注意事项​

  1. 数据安全：请求中的text字段可能包含敏感信息，请确保在传输过程中使用 HTTPS 协议，并对敏感数据进行加密处理。

  2. 频率限制：为避免服务过载，单个userId每分钟调用次数上限为 100 次，超出限制将返回错误，建议合理控制调用频率。

  1. 模型更新：levelValue参数对应的降重模型可能会不定期更新优化，建议定期查看文档获取最新模型配置及说明。

  2. 结果解释：降重后的文本应结合业务需求进一步审核，确保符合质量标准和语义要求。

  1. 错误处理：针对503等服务异常错误，建议在业务逻辑中添加重试机制，设置合理的重试间隔和次数，提升系统稳定性。