MIDA Core API 0.2

专注构建学习体验。
智能能力由 MIDA 复用。

一套实用的统一接口，把阅读、口语、作业、科学及未来教育应用连接到同一个儿童安全、中英双语的教育智能后端。

核心服务已运行 API 版本 v1 OpenAPI 3.1 English + 简体中文

核心接口

每个回答不只包含一段文字。

MIDA 在返回面向学习者的答案时，还会同时返回安全判断、教学策略、智能提供方、记忆保存结果和追踪标识。教育应用可以向孩子显示答案，同时让教师或管理系统使用这些结构化元数据。

学习者背景

年龄、语言、所需解释深度和最近的对话背景。

安全判断

允许、支持、引导或阻止，并提供风险类别和等级。

教学计划

年龄段、解释深度、教学策略和回答长度目标。

同意与记忆

是否保存教育历史，以及保存或未保存的明确原因。

首次请求

让 MIDA 进行解释。

公开演示允许同源请求，但不会保存对话历史。已连接的教育应用需要使用 API 密钥和租户信息进行认证。把 learner.language 设为 en 或 zh-CN，即可选择回答语言。

curl -X POST https://mida.skyed.cn/api/v1/chat \
  -H 'content-type: application/json' \
  -H 'x-mida-api-key: APPLICATION_SECRET' \
  -H 'x-mida-tenant-id: TENANT_UUID' \
  -H 'x-mida-client-id: CLIENT_UUID' \
  -d '{
    "message": "为什么月亮好像跟着我们走？",
    "learner": { "age": 9, "language": "zh-CN" },
    "requestedDepth": "balanced",
    "history": [],
    "consent": { "persistEducationalHistory": false }
  }'

接口列表

版本一刻意保持精简而完整。

GET/api/v1/health

查看服务状态和当前运行模式

GET/api/v1/capabilities

查询当前支持的教育能力

POST/api/v1/chat

运行完整的安全检查与解释流程

POST/api/v1/learners

创建或更新租户范围内的学习者

GET/api/v1/learners/{id}

在所属租户内读取学习者资料

DELETE/api/v1/learners/{id}

删除学习者及其全部关联记录

POST/api/v1/learners/{id}/consents

记录教育历史保存授权或撤回

GET/POST/api/v1/learners/{id}/memories

读取或添加已获同意的教育记忆

POST/api/v1/admin/bootstrap

创建租户和第一个应用客户端

POST/api/v1/admin/clients/{id}/revoke

立即撤销应用凭据

安全约定

三道相互独立的安全边界。

生成之前

在请求进入模型之前，先识别隐私、依赖、自我伤害、露骨性内容及严重伤害风险。

生成过程中

智能提供方会收到固定的身份、教学、隐私、语言和儿童安全规则；用户内容不能改写这些规则。

生成之后

答案还会检查保密诱导、关系隔离、不安全的权威声明，以及索取儿童敏感信息等问题。

运行配置

连接经过批准的智能提供方。

没有模型凭据时，MIDA 会使用经过验证的演示知识库。正式部署可以连接服务器端、兼容 Chat Completions 的智能提供方，同时保持客户端接口不变。

MIDA_ADMIN_KEY仅用于创建租户的服务器密钥；每个应用会生成独立凭据

MIDA_ALLOWED_ORIGINS以逗号分隔的获准应用来源地址

MIDA_MODEL_ENDPOINT完整的服务器端模型接口地址

MIDA_MODEL_API_KEY只保存在服务器端的模型提供方凭据

MIDA_MODEL_NAME已配置的模型标识符

专注构建学习体验。智能能力由 MIDA 复用。