资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

作文批改

概述

针对K9作文,对词汇、句子、段落、整体进行优缺点分析,并给出优化建议。

接口定义

URL https://qianfan.baidubce.com/v2/tools/ai_education/k9_composition_correction
Method POST

Headers

字段
Authorization Bearer {ApiKey}
Content-Type application/json
X-Appbuilder-Request-Id 非必填项(建议填写,方便后续链路问题排查,UUID格式)

请求参数

字段 类型 必填 说明
parameters dict 调用传参,具体见下文Parameters对象定义

Parameters对象

字段 类型 必填 说明
content string 作文内容,需要进行评价和打分的作文内容

请求示例

curl --request POST \
  --url https://qianfan.baidubce.com/v2/tools/ai_education/k9_composition_correction \
  --header 'Authorization: Bearer xxxxxx' \
  --header 'HOST: qianfan.baidubce.com' \
  --header 'content-type: application/json' \
  --data '{
    "stream": false,
    "parameters": {
        "content": "我是一名小学生,我爱吃糖,喜欢甜甜的味道。不管是伤心,内疚,疼苦,糖总能安抚我受伤的心灵。"
    }
}'

响应参数

正确响应

字段 类型 必填 说明
requestId string 请求ID
code string 错误代码,当发生异常时返回
message string 错误消息,当发生异常时返回
status string 当前对话状态。
running:对话进行过程中
done:对话结束
error:执行过程发生错误
interrupt:中断
content list[Content] 当前组件返回内容的主要payload,List[Content],每个 Content 包括了当前 event 的一个元素,具体见下文Content对象定义。

Content对象

字段 类型 必填 说明
type string 代表event 类型。该字段的取值决定了下面text字段的内容结构。
枚举值:
text、json、code、files、urls、oral_text、references、image、chart、audio、function_call。
text dict object 代表当前 event 元素的内容,每一种 event 对应的 text 结构固定。
+data string 响应的具体内容字符串
event dict 标识返回内容的结构、顺序、状态,具体见下文Event对象定义。

Event对象

字段 类型 必填 说明
status string 事件执行状态。
枚举值:
preparing:运行中。
running:运行中。
error:错误。
done:执行完成。
error_code string 错误码。
error_message string 错误细节。

响应示例

{
    "code": "",
    "message": "",
    "status": "done",
    "content": [
        {
            "type": "json",
            "text": {
                "data": "{\"output\":\"- 错别字纠正:作文中“疼苦”应改为“痛苦”。\\n- 句式优化:“不管是伤心,内疚,疼苦,糖总能安抚我受伤的心灵”这句话中,列举情绪时用逗号不太合适,可改为顿号,即“不管是伤心、内疚、痛苦,糖总能安抚我受伤的心灵”。\\n- 段落组织:作文只有一段,内容较为简短,可适当增加一些内容,比如描述一下自己爱吃的糖的种类,或者吃糖时的具体感受等,让段落更丰富。\\n- 作文打分:错别字方面扣1分,得7分;句式优化方面扣1分,得7分;段落组织方面扣2分,得6分;总体打分6分。\\n\\n个性化训练建议:平时多注意字词的正确书写,可以通过制作错别字卡片的方式加强记忆;学习不同句式的运用,多读一些优秀的作文,积累好的句式表达;在写作前可以先列一个简单的提纲,规划好段落内容,让文章结构更清晰。\"}"
            },
            "event": {
                "status": "done",
                "error_code": "",
                "error_message": ""
            }
        }
    ],
    "requestId": ""
}

异常响应

字段 类型 是否必填 说明
requestId str 请求ID
code str 0 表示成功,其他都是异常
message str 错误消息
detail 异常详情信息
上一篇
作文润色
下一篇
探索广场