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

作文润色

概述

对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 异常详情信息
上一篇
题目解析
下一篇
作文批改