DEVELOPER DOCUMENTATION
API 开发者文档
从身份认证、请求约定到五大产品接口,用一套稳定边界接入海南云图 AI 教育能力。
申请 API 试用 →START
5 分钟快速接入基础地址
https://api.example.com
审核通过后,在独立管理端创建应用和 API Key。所有请求均返回请求 ID,并计入机构级调用日志。
AUTH
API Key + Scopecurl "https://api.example.com/api/public/knowledge-points?subject=math&grade=7" \ -H "x-api-key: yuntu_xxxxxxxxx" \ -H "Accept: application/json"
- x-api-key
- 机构应用密钥
- Scope
- 能力授权范围
- Quota
- 分钟、日、月额度
- Request ID
- 调用追踪标识
GET
/api/public/knowledge-points已开放知识图谱 + 智能题库 API
按学科、年级、教材版本、章节和关键词检索知识点。需要 knowledge:read Scope。
- subject
- 学科
- grade
- 年级
- versionKey
- 教材版本
- keyword
- 知识点关键词
GET
/api/public/vocab/manifest已开放词书 Vocab API
读取已发布词书目录、Manifest、抽样与自适应抽题。需要 vocab:read Scope。下游 MentoraAI 通过服务端 ApiKey 消费。
- version
- Manifest 缓存协商
- bookId
- 词书稳定 ID
- layer
- 自适应词频层 1-8
- Scope
- vocab:read
POST
/v1/micro-courses申请后开放AI 全自动微课生成 API
提交知识点、年级、教材版本和目标时长,创建异步微课生成任务。
申请联合验证 →POST
/v1/explanations申请后开放AI 数字人讲题 API
提交题目、学生答案和讲解层级,返回分步解析与讲题任务。
申请联合验证 →POST
/v1/assessments申请后开放知识点智能测评 API
根据知识点范围、难度和题量创建测评并生成诊断结果。
申请联合验证 →POST
/v1/learning-paths申请后开放自适应学习路径 API
结合学生掌握度、目标和内容供给生成动态学习路径。
申请联合验证 →SDK
Python · JavaScript · Java · GoSDK 与技术支持
标准版及以上机构可获得 SDK、联调说明和调用监控;具体语言版本随正式开放接口逐步提供。