作文润色

更新时间：2025-09-22

概述

对K9作文按照词汇、句子进行润色，优化段落结构，并给出范文参考。

接口定义

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

Headers

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

请求参数

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

Parameters对象

字段	类型	必填	说明
content	string	是	作文内容，需要进行润色的文本

请求示例

curl --location 'https://qianfan.baidubce.com/v2/tools/ai_education/k9_composition_polishing' \
--header 'X-Appbuilder-Authorization: Bearer ***' \
--header 'X-Appbuilder-Request-Id: test-request-123' \
--header 'X-Appbuilder-User-Id: test-user-456' \
--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，见 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\":\"[ {\\\"original\\\": \\\"今天我去公园玩\\\", \\\"optimized\\\": \\\"今天阳光明媚，我怀着兴奋的心情，蹦蹦跳跳地来到了美丽的公园玩耍。\\\"}, {\\\"original\\\": \\\"天气很好\\\", \\\"optimized\\\": \\\"天空湛蓝，像被清水洗过一样，白云像棉花糖一样漂浮，天气好极了。\\\"}, {\\\"original\\\": \\\"我很开心\\\", \\\"optimized\\\": \\\"我像一只快乐的小鸟，在公园里跑来跑去，脸上洋溢着灿烂的笑容。\\\"} ]\"}"
      },
      "event": {
        "status": "done",
        "error_code": "",
        "error_message": ""
      }
    }
  ],
  "requestId": "test-request-123"
}

异常情况下的响应体

字段	类型	是否必填	说明
requestId	str	是	请求ID
code	str	否	0 表示成功，其他都是异常
message	str	否	错误消息
detail		否	异常详情信息

题目解析

作文批改