学术大模型API接口文档(V 1.30)

本文档提供了学术大模型API服务的详细说明,帮助开发者快速集成论文降重、论文降AIGC测功能。通过统一API接口,您可以调用降重、降AIGC、复合接口的服务。我们的API支持HTTPS协议,返回JSON格式的数据。

接口地址(仅支持https):

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

新版本特性预告:1、进一步提升改写效果;2、兼容格子达平台的aigc检测。

本接口只能对文本进行处理,具体看下方的请求示例。如果有上传文档进行处理且需要保持文档格式的需求,可联系工作人员进行接口定制(支持docx和doc文档),微信:GDDMDD

API认证方式

所有API请求都需要在Header中添加认证信息:

{
    "Authorization": "Bearer <接口密钥>"
  }

如果已登录,请前去个人中心设置接口密钥

接口说明

通过service_type参数指定服务类型,分别有降重、降AIGC和复合服务。

cURL 示例

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

请求参数说明

参数名类型是否必填说明
textstring需要处理的文本内容
service_typestring服务类型:aigc表示降aigc;jc表示降重;complex表示复合

响应示例

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

响应字段说明

字段名类型说明
codestring业务代码,成功时为success,错误的业务代码请异步下方的http响应码说明
messagestring错误信息,成功时为空
request_idstring请求唯一标识
output_textstring处理后的文本
input_text_countnumber输入文本字数,按此字数进行扣除
service_typestring实际使用的服务类型,和请求体中的service_type值保持一致

注意:complex复合模式字数扣除的规则为input_text_count*1.5倍。

重要知会

  1. 请求体参数text内容要求:除要改写的内容外,不能包含任何任务描述、指令或额外内容,否则会影响处理效果。代码、数学公式等内容不建议改写,意义不大且浪费字数。
  2. 请求体参数text长度建议:不宜超过1000字,越长的内容代表改写任务越复杂,会导致改写效果下降。
  3. 字数减扣规则:
    • 降重和降AIGC模式:按照text长度进行减扣,不足100字时按100字计算;
    • 复合模式:按照text长度的1.5倍进行减扣,不足100字时,按照150字计算;
  4. 字数统计规则:尽最大努力和MS Office、WPS的统计规则保持一致,若您发现字数统计有误,请联系平台工作人员。
  5. 改写效果:本接口无法保证每次请求的改写效果。举例:一篇文章aigc检测为10%,意味着有些段落的aigc特征依然明显。同理,您将一篇文章通逐个段落通过本接口改写时,并不能保证每个段落都能达到一样的效果。若您介意这个问题,请慎重考虑购买事宜。
  6. 改写格式:本接口无法保证改写结果的段落数量。正常情况下,如果text参数中包含,那么改写的结果大概率也包含,即传给接口的是两个段落,那么改写结果一般也是两段。
  7. 改写结果的字数:本接口无法保证输出和输入保持一样的字数,这是由大模型决定的,非人力可介入。
  8. 大模型生成参数/采样参数:为确保稳定的改写效果,本接口不开放生成参数/采样参数(temperature、top_p等),敬请谅解。
  9. 流式/非流式:本接口不支持流式响应,如果您需求流式响应,请联系平台工作人员,我们将会综合评估。
  10. 关于请求错误:请求错误且发生字数减扣时,字数自动退步账号且不会另行通知。

平台工作人员微信:GDDMDD

http响应码说明

错误码说明响应内容示例
400可用字数不足{ "code": "useageLimitedFailed", "message": "可用字数不足" }
400敏感词触发{ "code": "dataInspectionFailed", "message": "文本触发了绿网敏感词规则" }
401无效的接口密钥{ "code": "unauthorized", "message": "无效的接口密钥" }
403无效的Authorization结构{ "detail": "缺少有效的Authorization结构. 请使用'Bearer API_KEY'", }
429限流{ "code": "llmLimited", "message": "触发限制,稍后重试" }
500服务器内部错误{ "code": "internalFailed", "message": "internal error" }
500大模型内部错误{ "code": "llmInternalFailed", "message": "学术模型内部异常" }