\n
\n\n
\nPOST
\n\nhttps://qianfan.baidubce.com/v2/tools/ai_education/k9_composition_multimodal\n
\n本接口基于AI大模型能力，支持用户上传初中作文图片URL，自动对图片中的手写或打印作文进行识别与提取，快速返回作文的标题和正文文本。
\n该组件为付费功能，具体计费说明请参见使用文档。
权限说明
\n调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
\n请求参数
\n\n
\n\n
\n\n
\n\n
\nHeaders 参数
\n除公共头域外，无其它特殊头域
\n\n
\n\n
\nBody 参数
\n\n
\n\n
\n\n\n
\n\n\nparameters\n\nobject {1}\n
\n工具调用参数对象。
\n必选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n\n
\n\n\nimage_url\n\nstring\n
\n图片链接，一次仅能上传一个图片。
\n必选
\n\n\n
\n\n\nstream\n\nboolean\n
\n是否流式返回。
可选值：
true：流式。
false：非流式。
必选
\n\n
\n\n
\n\n
\n请求结构
\n\n\n\n
\n\n
\nPOST /v2/tools/ai_education/k9_composition_multimodal HTTP/1.1\nHOST: qianfan.baidubce.com\nAuthorization: Bearer <API Key>\nContent-Type: application/json\n{\n \"stream\": false,\n \"parameters\": {\n \"image_url\": \"https://wangqu03.bj.bcebos.com/答案2.png?authorization=bce-auth-v1/418316205313419aada1d619b84a50e4/2025-08-20T07:51:16Z/-1/host/23080da741918ec3b0773034d8d91ff567ef01b0f647e14ec3352651d4716fb8\"\n }\n}示例代码
\n\n\n
\n\n
\n\n
\n\n
\n请求示例
\n\n\n\n
\n\n
\ncurl -X POST \"https://qianfan.baidubce.com/v2/tools/ai_education/k9_composition_multimodal\" \\\n -H \"Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"stream\": false,\n \"parameters\": {\n \"image_url\": \"https://wangqu03.bj.bcebos.com/答案2.png?authorization=bce-auth-v1/418316205313419aada1d619b84a50e4/2025-08-20T07:51:16Z/-1/host/23080da741918ec3b0773034d8d91ff567ef01b0f647e14ec3352651d4716fb8\"\n }\n }'返回响应
\n\n
\n\n
\n\n
\n\n
\nHeaders 参数
\n除公共头域外，无其它特殊头域
\n\n
\n\n
\n返回参数
\n\n
\n\n
\n\n\n
\n\n\ncode\n\nstring\n
\n错误代码，当发生异常时返回。
\n可选
\n\n\n
\n\n\nmessage\n\nstring\n
\n错误消息，当发生异常时返回。
\n可选
\n\n\n
\n\n\nstatus\n\nstring\n
\n当前对话状态。
running:对话进行过程中。
done：对话结束
error：执行过程发生错误。
interrupt：中断
可选
\n\n\n
\n\n\ncontent\n\narray\n
\n当前组件返回内容的主要 payload，每个元素为一个 Content 对象，包含当前 event 的一个元素。
可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n
\n\n\nitems\n\nobject {4}\n
\n\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n\n
\n\n\ntype\n\nstring\n
\n代表event 类型。该字段的取值决定了下面text字段的内容结构。
枚举值：
text、json、code、files、urls、oral_text、references、image、chart、audio、function_call。
可选
\n\n\n
\n\n\nname\n\nstring\n
\n介绍当前 yield 内容的 step name。
\n可选
\n\n\n
\n\n\ntext\n\nobject {1}\n
\n当前事件的文本内容对象。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n\n
\n\n\ndata\n\nstring\n
\n对应图片识别的具体内容，数据格式根据 type 字段决定，若 type 为 json，则此处为 JSON 字符串。
可选
\n\n\n
\n\n\nevent\n\nobject {3}\n
\n当前事件的执行状态信息。
\n可选
\n\n\n
\n
\n\n\n\n显示子属性\n隐藏子属性\n\n
\n\n
\n\n\n
\n\n\nstatus\n\nstring\n
\n事件执行状态。枚举值：
preparing：运行中
running：运行中
error：错误
done：执行完成
可选
\n\n\n
\n\n\nerror_code\n\nstring\n
\n错误码。
\n可选
\n\n\n
\n\n\nerror_message\n\nstring\n
\n错误细节。
\n可选
\n\n\n
\n\n\nrequestId\n\nstring\n
\n请求ID。
\n可选
\n\n
\n\n\n
\n\n
\n\n
\n\n
\n成功示例
\n\n\n\n
\n\n
\n{\n \"code\": \"\",\n \"message\": \"\",\n \"status\": \"done\",\n \"content\": [\n {\n \"type\": \"json\",\n \"text\": {\n \"data\": \"{\\\"title\\\":\\\"暖\\\",\\\"content\\\":\\\"敬爱的燕妈：\\\\n\\\\n蓦然回首，还记得您是在初二时接手了我们这个班，正处于叛逆期的我们没少给您惹麻烦，但和您一起度过了最美好时光，拍下了满载青春活力的镜头。\\\\n\\\\n您总每一句话，每一个鼓励的眼神犹如\\\"随风潜入夜，润物细无声\\\"地滋润我们心里，让我们感觉到一阵暖流。还记得初二那年社会实践，我本以为要去山上很渴，完全没有任何表演经验的二战非常紧张，在台前前，我的头已经全是汗水，这时您来了，您用一句幽默风趣的话一下使我轻松起来，最后，还用您二手机在二楼楼梯上拍了两下，我信心大增。不管结局如何，那是一次二自我突破。爸爸的话让我心头一暖，我知道那是莫大的鼓励。\\\\n\\\\n初二下学期的地理生物小中考，这是我们面临第一个大考，我很紧张，您也很紧张，为了我们三小中考，您放弃了自己二午休时间，让我们留在学校进行学习。看到您这么不辞辛苦为我们准备，经常鼓励我们，我又一次心头一暖。\\\\n\\\\n时光荏苒，岁月如梭，很快我到了初三下学期，距离中考只剩下147天了，我又再一次感受到了巨大的学习压力，面对这些压力，有二同学有目标地在冲刺，而有二同学茫然无措地应顾每天二作业，而我就在其中一个。但每天都会在我们一腹心灵鸡汤鼓励着我们，但我始终记得那一句话：不要等事情发生了才后悔莫及，所以我们一定要跑在时间前面。您就念得这句话，让我懂得了应该珍惜当下，好好努力。\\\\n\\\\n旦暖滇心师玉精，冰冻心温暖，累在心尖，不消。\\\\n\\\\n您的学生王诚。\\\"}\"\n },\n \"event\": {\n \"status\": \"done\",\n \"error_code\": \"\",\n \"error_message\": \"\"\n }\n }\n ],\n \"requestId\": \"\"\n}