DEVELOPER DOCUMENTATION

API 开发者文档

从身份认证、请求约定到五大产品接口,用一套稳定边界接入海南云图 AI 教育能力。

申请 API 试用 →
START5 分钟快速接入

基础地址

https://api.example.com

审核通过后,在独立管理端创建应用和 API Key。所有请求均返回请求 ID,并计入机构级调用日志。

AUTHAPI Key + Scope
curl "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

结合学生掌握度、目标和内容供给生成动态学习路径。

申请联合验证 →
SDKPython · JavaScript · Java · Go

SDK 与技术支持

标准版及以上机构可获得 SDK、联调说明和调用监控;具体语言版本随正式开放接口逐步提供。