作文看图写作-图片生成题干
开放接口-系列:
作文看图写作,生成文字题干
将提供的图片,转成示意的文字。适用于看图写话图片转为文字材料。
- HTTP 方法:POST
- 请求地址
1
https://api.21days.cloud/opi/p/c012/zuowen/image_to_topic
- URL参数:无
- Header:accessToken鉴权
- Body:
| 字段名 | 类型 | 描述 |
|---|---|---|
| topic_content_image | string | 图片链接字符串,需为公网可访问的图片 URL,建议使用清晰的原始题图(避免包含课本边框、桌面等大面积无关区域) |
| language | int | 需要哪种语言,0=中文,1=英语。目前主要用于控制返回题干语言,不影响图片识别准确性 |
3. 返回响应
| 字段 | 类型 | 必选 | 示例 | 解释 |
|---|---|---|---|---|
| code | Number | 是 | 0 | 1=正常,0=异常,-1=未登录 |
| msg | String | 否 | - | 提示信息 |
| data | object | 否 | ||
| data.topic_content | str | 否 | 返回的文本 |
使用建议与常见异常
图片建议:
- 尽量使用单页、无遮挡的清晰截图或扫描件;
- 避免过暗、反光、倾斜严重的图片;
- 如图中包含多张小图,生成的题干会尽量综合主要信息,但可能无法覆盖所有细节。
典型失败场景(
code=0):- 无法下载图片(URL 无效或无访问权限);
- 图片中无明显文字或内容过于简单,无法生成有意义的题干;
- OCR 识别失败(可对比作文批改主流程中的 1001 场景)。
业务方可根据 msg 做友好提示,如“请上传更清晰的图片”或“当前图片无法识别,请更换图片后重试”。
