学术大模型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"
请求参数说明
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
text | string | 是 | 需要处理的文本内容 |
service_type | string | 是 | 服务类型:aigc表示降aigc;jc表示降重;complex表示复合 |
响应示例
{
"code": "success",
"message": "",
"request_id": "0009837a1ee1408d9550864e8c357fc4",
"output_text": "高村乡农村集体经济发展重要的是带头人能力强...",
"input_text_count": 169,
"service_type": "jc"
}
响应字段说明
字段名 | 类型 | 说明 |
---|---|---|
code | string | 业务代码,成功时为success,错误的业务代码请异步下方的http响应码说明 |
message | string | 错误信息,成功时为空 |
request_id | string | 请求唯一标识 |
output_text | string | 处理后的文本 |
input_text_count | number | 输入文本字数,按此字数进行扣除 |
service_type | string | 实际使用的服务类型,和请求体中的service_type值保持一致 |
注意:complex复合模式字数扣除的规则为input_text_count*1.5倍。
重要知会
- 请求体参数text内容要求:除要改写的内容外,不能包含任何任务描述、指令或额外内容,否则会影响处理效果。代码、数学公式等内容不建议改写,意义不大且浪费字数。
- 请求体参数text长度建议:不宜超过1000字,越长的内容代表改写任务越复杂,会导致改写效果下降。
- 字数减扣规则:
- 降重和降AIGC模式:按照text长度进行减扣,不足100字时按100字计算;
- 复合模式:按照text长度的1.5倍进行减扣,不足100字时,按照150字计算;
- 字数统计规则:尽最大努力和MS Office、WPS的统计规则保持一致,若您发现字数统计有误,请联系平台工作人员。
- 改写效果:本接口无法保证每次请求的改写效果。举例:一篇文章aigc检测为10%,意味着有些段落的aigc特征依然明显。同理,您将一篇文章通逐个段落通过本接口改写时,并不能保证每个段落都能达到一样的效果。若您介意这个问题,请慎重考虑购买事宜。
- 改写格式:本接口无法保证改写结果的段落数量。正常情况下,如果text参数中包含,那么改写的结果大概率也包含,即传给接口的是两个段落,那么改写结果一般也是两段。
- 改写结果的字数:本接口无法保证输出和输入保持一样的字数,这是由大模型决定的,非人力可介入。
- 大模型生成参数/采样参数:为确保稳定的改写效果,本接口不开放生成参数/采样参数(temperature、top_p等),敬请谅解。
- 流式/非流式:本接口不支持流式响应,如果您需求流式响应,请联系平台工作人员,我们将会综合评估。
- 关于请求错误:请求错误且发生字数减扣时,字数自动退步账号且不会另行通知。
平台工作人员微信: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": "学术模型内部异常" } |