Maas2-group/Maas-Model-platform: 网讯创智模型管理平台

切题及题目结构化接口，客户输入试卷或整页题目图片，算法返回每个题目的位置信息以及结构化（题干、选项、答案等）信息。

接口说明

开通 EduTutor 服务。本接口在公测阶段，每个账号每天可以免费调用 1000 次。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
edututor:CutQuestions	none	\全部资源 ``	无	无

请求语法

POST /service/cutApi HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
workspaceId	string	是	当前请求所使用的百炼业务空间 id。	llm-1ijrzuv3v0ivvls7
body	object	否	请求 body。
image	string	是	试卷、题目图片链接。	https://oss.xxx.com/xx.png
parameters	object	是	参数配置。
struct	boolean	是	是否返回结构化信息。	true
extract\_images	boolean	是	是否返回子题临时 oss 链接，便于后续答题直接使用。	true

返回参数

名称	类型	描述	示例值
	object	Schema of Response
requestId	string	请求 id，每次请求都是唯一值，便于后续排查问题。	1CE2851D-96D6-51D0-8ADA-EB7ACAF374BB
success	boolean	调用是否成功。	True
code	string	响应状态码。	SUCCESS
httpStatusCode	integer	http 状态码。	200
message	string	返回码描述。	success
data	string	算法返回结果。	'{ "questions": \[ { "pos\_list": \[ \[ 21, 0, 364, 0, 364, 82, 21, 82 \] \], "sub\_images": \[ "http://duguang-mld.oss-accelerate.aliyuncs.com/ocr\_edu/1CE2851D-96D6-51D0-8ADA-EB7ACAF374BB\_0\_0.png?OSSAccessKeyId=LTAI5tPtEwpyT4JR9Gym\\\\&Expires=1755593474&Signature=SnqwepQVvZ51PnUGtpH0fWV50JI%3D" \], "merged\_image": "http://duguang-mld.oss-accelerate.aliyuncs.com/ocr\_edu/1CE2851D-96D6-51D0-8ADA-EB7ACAF374BB\_0\_0.png?OSSAccessKeyId=LTAI5tPtEwpyT4JR9Gy\\\\&Expires=1755593474&Signature=SnqwepQVvZ51PnUGtpH0fWV50JI%3D", "info": { "stem": { "text": "8. 若 \\\\\\\\(a + b = -1\\\\\\\\), \\\\\\\\(ab = 4\\\\\\\\), 则 \\\\\\\\((4a - 5b - 3ab) - (3a - 6b + ab)\\\\\\\\) 的值为 \_ 。", "pos\_list": \[ \[ 21, 4, 364, 4, 364, 78, 21, 78 \] \] }, "option": \[\], "figure": \[\], "answer": \[ { "text": "-17", "pos\_list": \[ \[ 225, 51, 262, 51, 262, 70, 225, 70 \] \] } \], "type": "填空题", "subquestion": \[\] } } \] }'
input\_tokens	integer	此次调用输入消耗的 token 数。	80
output\_tokens	integer	此次调用输出消耗的 token 数。	38

[](#算法结果字段-data)算法结果字段 data

需要序列化，字段说明如下：

字段	类型	描述	示例值
questions	array	模型切出来的题目数组。
questions\[i\].pos\_list	array	第 i 道题目的坐标框（可能含有多个）。	\[\[21,0,364,0,364,82,21,82\]\]
questions\[i\].sub\_images	array	根据坐标框提取出来的子图图片链接（7 天有效）。
questions\[i\].merged\_image	string	所有子图合并之后的题目完整图片链接（7 天有效）。
questions\[i\].info	object	题目结构化信息。
questions\[i\].info.type	string	题目类型：选择题/填空题/判断题/问答题/作文题/其他。	填空题
questions\[i\].info.stem	array	题干信息。
questions\[i\].info.stem.text	string	题干文本信息。
questions\[i\].info.stem.pos\_list	array	题干坐标框信息。
questions\[i\].info.option	array	选项信息。
questions\[i\].info.option\[j\].text	string	选项文本信息。
questions\[i\].info.option\[j\].pos\_list	array	选项位置信息。
questions\[i\].info.figure	array	插图信息。
questions\[i\].info.figure\[k\].pos\_list	array	插图位置信息。
questions\[i\].info.answer	array	答案信息。
questions\[i\].info.answer\[m\].pos\_list	array	答案位置信息。	"-17"
questions\[i\].info.answer\[m\].text	string	答案文本信息。
questions\[i\].info.subquestion	array	子题信息（结构和 info 一致）。

举例：

{
    "questions": [
        {
            "pos_list": [
                [
                    21,
                    0,
                    364,
                    0,
                    364,
                    82,
                    21,
                    82
                ]
            ],
            "sub_images": [
                "http://xxxxx/sub_images/1CE2851D-96D6-51D0-8ADA-EB7ACAF374BB_0_0.png"
            ],
            "merged_image": "http://xxxxx/sub_images/1CE2851D-96D6-51D0-8ADA-EB7ACAF374BB.png",
            "info": {
                "stem": {
                    "text": "8. 若 \\\\(a + b = -1\\\\), \\\\(ab = 4\\\\), 则 \\\\((4a - 5b - 3ab) - (3a - 6b + ab)\\\\) 的值为 _ 。",
                    "pos_list": [
                        [
                            21,
                            4,
                            364,
                            4,
                            364,
                            78,
                            21,
                            78
                        ]
                    ]
                },
                "option": [],
                "figure": [],
                "answer": [
                    {
                        "text": "-17",
                        "pos_list": [
                            [
                                225,
                                51,
                                262,
                                51,
                                262,
                                70,
                                225,
                                70
                            ]
                        ]
                    }
                ],
                "type": "填空题",
                "subquestion": []
            }
        }
    ]
}

示例

正常返回示例

JSON格式

{
  "requestId": "1CE2851D-96D6-51D0-8ADA-EB7ACAF374BB",
  "success": true,
  "code": "SUCCESS",
  "httpStatusCode": 200,
  "message": "success",
  "data": "'{\n    \"questions\": [\n        {\n            \"pos_list\": [\n                [\n                    21,\n                    0,\n                    364,\n                    0,\n                    364,\n                    82,\n                    21,\n                    82\n                ]\n            ],\n            \"sub_images\": [\n                \"http://duguang-mld.oss-accelerate.aliyuncs.com/ocr_edu/1CE2851D-96D6-51D0-8ADA-EB7ACAF374BB_0_0.png?OSSAccessKeyId=LTAI5tPtEwpyT4JR9Gym****&Expires=1755593474&Signature=SnqwepQVvZ51PnUGtpH0fWV50JI%3D\"\n            ],\n            \"merged_image\": \"http://duguang-mld.oss-accelerate.aliyuncs.com/ocr_edu/1CE2851D-96D6-51D0-8ADA-EB7ACAF374BB_0_0.png?OSSAccessKeyId=LTAI5tPtEwpyT4JR9Gy****&Expires=1755593474&Signature=SnqwepQVvZ51PnUGtpH0fWV50JI%3D\",\n            \"info\": {\n                \"stem\": {\n                    \"text\": \"8. 若 \\\\\\\\(a + b = -1\\\\\\\\), \\\\\\\\(ab = 4\\\\\\\\), 则 \\\\\\\\((4a - 5b - 3ab) - (3a - 6b + ab)\\\\\\\\) 的值为 _ 。\",\n                    \"pos_list\": [\n                        [\n                            21,\n                            4,\n                            364,\n                            4,\n                            364,\n                            78,\n                            21,\n                            78\n                        ]\n                    ]\n                },\n                \"option\": [],\n                \"figure\": [],\n                \"answer\": [\n                    {\n                        \"text\": \"-17\",\n                        \"pos_list\": [\n                            [\n                                225,\n                                51,\n                                262,\n                                51,\n                                262,\n                                70,\n                                225,\n                                70\n                            ]\n                        ]\n                    }\n                ],\n                \"type\": \"填空题\",\n                \"subquestion\": []\n            }\n        }\n    ]\n}'",
  "input_tokens": 80,
  "output_tokens": 38
}

错误码

访问错误中心查看更多错误码。

拍照搜题cutapi.md 9.9 KB Permalink Verlauf Originalformat