切题是从一张完整的题目或试卷照片中定位出一道或多道题的边界，输出可供后续解题、批改场景使用的独立题图和文本信息。本文档介绍切题API接口的输入输出参数。

接口限流：火山账号维度，默认120RPM。

认证方式

接口详情

URL

URL	ApiKey: https://open.feedcoopapi.com/agent_api/agent/edu_question/cut Top: https://mercury.volcengineapi.com?Action=EduQuestionCut&Version=2026-01-01
Method	POST
Header	API Key接入： Authorization: Bearer <API_KEY> Content-Type：application/json ServiceName: ask_echo Access Key接入： Content-Type：application/json 此接入方式基于火山引擎访问控制的AK/SK鉴权，统一使用 ServiceName=ask_echo，接口验签及请求公共参数逻辑遵循火山引擎官网的统一规范，详情请参见：签名方法--API签名调用指南-火山引擎；

请求体

EduQuestionCutRequest

参数	类型	必需	描述
image_base64	String	否	与image_url字段二选一，两字段都传，默认使用image_base64 图片base64，需要满足DataUrl格式data:{MIME Type};base64,{base64_image} 示例：data:image/jpeg;base64,{base64_image} 图片格式支持：JPEG、PNG、GIF、WEBP、BMP、TIFF、HEIC、HEIF（详情见图片格式说明）单张图片大小：推荐大小：<=500KB 最大限制： WebUrl传入 APIKey接入：单张图片大小<10M，超出会报参数错误 TOP网关接入：请求体整体长度不能超过8M DataUrl传入 APIKey接入：单张图片Base64编码后长度<20M，超出会报参数错误 TOP网关接入：请求体整体长度不能超过8M 单图片尺寸判断，如果图片超出下面的限制，会直接报错，传入图片满足下面条件（单位 px）：宽 > 14 且高>14 宽*高范围： [196, 36000000]
image_url	String	否	图片WebUrl，建议优先使用image_base64字段，WebUrl需要下载，可能存在下载延迟和不稳定问题字段限制与图片限制见image_base64字段描述
cut_type	String	是	切题类型，枚举值： snap_qa：建议解题场景（无手写的场景）使用该枚举值。 homework_mark：建议作业批改场景（多题、含手写的场景）使用该枚举值。
enable_image_dewarp	Boolean	否	是否开启图片矫正预处理，默认开启。
enable_orientation_classification	Boolean	否	是否开启智能图片方向检测，默认开启。

响应体

EduQuestionCutResponse

参数	类型	必需	描述
preprocessed_image_base64	String	是	预处理后的DataUrl格式 base64 编码图片。
subject_type	Enum(SubjectType)	是	学科类型。
department_type	Enum(DapartmentType)	是	学段类型。
cut_results	Array<EduQuestionCutResult>	是	切题结果列表。
orientation	Enum(Orientation)	否	图片方向。
dewarp_strength	Number	否	图片矫正强度。

EduQuestionCutResult

参数	类型	必需	描述
cut_points	Array<ImagePoint>	是	切题框坐标。
question_type	Enum(QuestionType)	是	题目分类。
ocr_result	OcrResult	否	OCR 识别结果。
figure_detection_result	Array<FigureDetectionResult>	否	图形检测结果。

OcrResult

OcrLineResult

参数	类型	必需	描述
line_text	String	是	每行文本内容。
line_type	Enum(LineType)	是	行文本类型。
line_points	Array<ImagePoint>	是	行文本坐标。
score	Number	是	每行文本置信度。
character_result	Array<OcrLineCharacterResult>	是	字符级识别结果。

OcrLineCharacterResult

FigureDetectionResult

ImagePoint

枚举值

SubjectType

DapartmentType

QuestionType

TextCharType

LineType

ClassName

Orientation

请求示例

响应示例

错误处理

错误响应

响应格式如下：

使用说明

图片格式说明

支持的图片格式如下表。