作文润色
更新时间: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 | 否 | 异常详情信息 |