作文批改
更新时间:2025-09-19
概述
针对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 | 是 | 作文内容,需要进行评价和打分的作文内容 |
请求示例
Plain Text
1curl --request POST \
2 --url https://qianfan.baidubce.com/v2/tools/ai_education/k9_composition_correction \
3 --header 'Authorization: Bearer xxxxxx' \
4 --header 'HOST: qianfan.baidubce.com' \
5 --header 'content-type: application/json' \
6 --data '{
7 "stream": false,
8 "parameters": {
9 "content": "我是一名小学生,我爱吃糖,喜欢甜甜的味道。不管是伤心,内疚,疼苦,糖总能安抚我受伤的心灵。"
10 }
11}'
响应参数
正确响应
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
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 | 否 | 错误细节。 |
响应示例
Plain Text
1{
2 "code": "",
3 "message": "",
4 "status": "done",
5 "content": [
6 {
7 "type": "json",
8 "text": {
9 "data": "{\"output\":\"- 错别字纠正:作文中“疼苦”应改为“痛苦”。\\n- 句式优化:“不管是伤心,内疚,疼苦,糖总能安抚我受伤的心灵”这句话中,列举情绪时用逗号不太合适,可改为顿号,即“不管是伤心、内疚、痛苦,糖总能安抚我受伤的心灵”。\\n- 段落组织:作文只有一段,内容较为简短,可适当增加一些内容,比如描述一下自己爱吃的糖的种类,或者吃糖时的具体感受等,让段落更丰富。\\n- 作文打分:错别字方面扣1分,得7分;句式优化方面扣1分,得7分;段落组织方面扣2分,得6分;总体打分6分。\\n\\n个性化训练建议:平时多注意字词的正确书写,可以通过制作错别字卡片的方式加强记忆;学习不同句式的运用,多读一些优秀的作文,积累好的句式表达;在写作前可以先列一个简单的提纲,规划好段落内容,让文章结构更清晰。\"}"
10 },
11 "event": {
12 "status": "done",
13 "error_code": "",
14 "error_message": ""
15 }
16 }
17 ],
18 "requestId": ""
19}
异常响应
字段 | 类型 | 是否必填 | 说明 |
---|---|---|---|
requestId | str | 是 | 请求ID |
code | str | 否 | 0 表示成功,其他都是异常 |
message | str | 否 | 错误消息 |
detail | 否 | 异常详情信息 |