作文批改
更新时间:2026-04-28
POST
https://qianfan.baidubce.com/v2/tools/ai_education/k9_composition_correction
本接口用于针对K9作文中词汇、句子、段落、整体进行优缺点分析,并给出优化建议。
该组件为付费功能,具体计费说明请参见使用文档。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
Headers 参数
除公共头域外,无其它特殊头域
Body 参数
parameters
object {1}
接口调用参数对象。
必选
显示子属性
隐藏子属性
content
string
作文内容,需要进行评价和打分的作文原文。
必选
stream
boolean
是否启用流式输出。
必选
请求结构
POST /v2/tools/ai_education/k9_composition_correction HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"stream": false,
"parameters": {
"content": "我是一名小学生,我爱吃糖,喜欢甜甜的味道。不管是伤心,内疚,疼苦,糖总能安抚我受伤的心灵。"
}
}
示例代码
curl
curl -X POST "https://qianfan.baidubce.com/v2/tools/ai_education/k9_composition_correction" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"stream": false,
"parameters": {
"content": "我是一名小学生,我爱吃糖,喜欢甜甜的味道。不管是伤心,内疚,疼苦,糖总能安抚我受伤的心灵。"
}
}'
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
code
string
错误代码,当发生异常时返回。
可选
message
string
错误消息,当发生异常时返回。
可选
status
string
当前对话状态。
running:对话进行过程中
done:对话结束
error:执行过程发生错误
interrupt:中断
可选
content
array
当前组件返回内容的主要 payload,每个元素为一个 Content 对象,包含当前事件的一个元素。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
type
string
事件类型,决定 text 字段的内容结构。
枚举值:
text、json、code、files、urls、oral_text、references、image、chart、audio、function_call。
可选
text
object {1}
响应文本对象,包含具体的输出内容。
可选
显示子属性
隐藏子属性
data
string
响应的具体内容字符串。
可选
event
object {3}
事件状态对象,包含当前事件的执行状态及错误信息。
可选
显示子属性
隐藏子属性
status
string
事件执行状态。
枚举值:
preparing:运行中。
running:运行中。
error:错误。
done:执行完成。
可选
error_code
string
错误码,发生错误时返回。
可选
error_message
string
错误详情,发生错误时返回。
可选
requestId
string
请求唯一ID。
可选
成功响应示例
{
"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": ""
}
评价此篇文章
