概览 - iMDT AI 服务

iMDT AI 服务是 MDT（多学科会诊）系统的 AI 能力服务，实现《AI调用接口协议》AI-1 ~ AI-7：发言完整性判定与整理、语音转写、病例资料脱敏分类、基本信息 OCR、病例结构化与质控、报告综合建议参考稿。

环境与入口

环境	地址
测试环境业务接口	`https://imdt-test.zhonghuimedical.com/ai/v1/...`
网页调试文档（Scalar）	`https://imdt-test.zhonghuimedical.com/claw/docs`
OpenAPI 3.0 schema	`https://imdt-test.zhonghuimedical.com/claw/openapi.json`
面向 AI 调用方的文档	`https://imdt-test.zhonghuimedical.com/claw/llms.txt`

生产环境域名由部署方提供，业务接口路径一律以 /ai/v1/ 为前缀。

接口一览

编号	方法与路径	模式	用途
AI-1 & AI-2	`POST /ai/v1/speech-process`	同步	发言要点完整性判定 + 发言整理
AI-3	`POST /ai/v1/report-advice-draft`	异步（回调）	报告综合建议参考稿
AI-4	`POST /ai/v1/case-file-process`	同步	病例资料脱敏与分类
AI-5	`POST /ai/v1/case-ocr`	同步	病例基本信息 OCR
AI-6	`POST /ai/v1/case-structure`	异步（回调）	病例结构化与质控
AI-7	`POST /ai/v1/asr`	同步	语音转写

另有三个运维端点无需鉴权：GET /health（健康检查，返回 {"ok": true}）、GET /docs、GET /openapi.json。

第一次调用

先确认服务可达：

curl https://imdt-test.zhonghuimedical.com/claw/health
# {"ok":true}

再发一个真实的业务请求（把 <共享令牌> 换成向后端/运维团队索取的令牌值）：

curl -X POST https://imdt-test.zhonghuimedical.com/ai/v1/speech-process \
  -H "Content-Type: application/json" \
  -H "x-imdt-ai: <共享令牌>" \
  -d '{
    "request_id": "r1",
    "cancer_type": "乳腺癌",
    "standard_department_code": "breast_surgery",
    "points": [{ "seq": 1, "name": "可切除性" }],
    "speech_text": "医生完整发言文本"
  }'

读文档的顺序

通用约定 —— 鉴权、request_id、同步/异步
错误处理 —— 统一错误形状与重试策略
回调协议 —— 对接 AI-3 / AI-6 必读
业务要点与红线 —— 各接口容易踩的坑
API 参考 —— 由 OpenAPI schema 自动生成的逐接口字段定义

​环境与入口

​接口一览

​第一次调用

​读文档的顺序

环境与入口

接口一览

第一次调用

读文档的顺序