开发者中心 - 超声造影人工智能诊断联合实验室

📋 API 概览

V1.0 · 生产环境

AIMED 充盈视界提供基于超声造影的 AI 诊断 API 服务，支持胃部/胰腺疾病的智能分析、医学知识检索、图像分割和区块链存证。所有接口统一使用 JSON 格式，RESTful 风格设计。

快速示例

# 发送诊断请求
curl -X POST https://www.aius.xin/api/v1/diagnose \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_id": "P001",
    "image_url": "https://example.com/ultrasound.jpg",
    "organ": "stomach",
    "contrast_agent": "充盈视界"
  }'

🔐 认证方式

🔑 Bearer Token 认证

所有 API 请求需在 Header 中携带 API Key：

Authorization: Bearer YOUR_API_KEY

如需申请 API Key，请联系 admin@aius.xin 或通过管理后台「开发者管理」页面获取。

🌐 Base URL

环境	URL	状态
生产环境	https://www.aius.xin/api/v1/	运行中
测试环境	http://localhost:18790/api/v1/	本地可用

🔬 诊断服务

POST /api/v1/diagnose AI 超声造影诊断

提交超声造影图像进行 AI 智能诊断，返回疾病概率、置信度和诊断建议。支持自动模型降级（DashScope → NVIDIA NIM）。

请求参数

参数	类型	必填	说明
patient_id	string	必填	患者唯一标识
image_url	string	必填	超声图像 URL 或 Base64
organ	string	必填	目标器官：`stomach` / `pancreas`
contrast_agent	string	可选	造影剂名称，默认「充盈视界」
clinical_info	object	可选	临床信息（病史、症状等）

响应示例

JSON · 200 OK

{
  "success": true,
  "diagnosis_id": "D-20260430-001",
  "organ": "stomach",
  "results": {
    "normal": 0.12,
    "gastritis": 0.65,
    "ulcer": 0.18,
    "tumor": 0.05
  },
  "confidence": 0.87,
  "suggestion": "建议进一步胃镜检查，疑似胃炎",
  "model": "qwen3.5-plus",
  "timestamp": "2026-04-30T20:00:00Z"
}

GET /api/v1/diagnose/{diagnosis_id} 查询诊断结果

根据诊断 ID 获取诊断报告详情。

📚 知识检索

GET /api/v1/knowledge/search 向量检索医学知识

基于 ChromaDB 向量检索，从 36 篇专业文档中搜索相关医学知识，覆盖指南共识、病理机制、诊疗方案等 6 大领域。

参数	类型	必填	说明
query	string	必填	搜索关键词或问题
category	string	可选	分类过滤：`guide`/`pathology`/`treatment`/`agent`/`contrast`/`protocol`
top_k	integer	可选	返回结果数，默认 5

✂️ 图像分割

POST /api/v1/segment SAM 图像分割

使用 Segment Anything Model (ViT-B) 对超声图像进行病灶区域分割，输出分割掩码和面积测量。

JSON · 请求示例

{
  "image_url": "https://example.com/ultrasound.jpg",
  "prompt_type": "box",
  "prompt": [100, 150, 300, 400]
}

📋 病例管理

GET /api/v1/cases/list 获取病例列表

分页获取病例列表，支持按患者、器官、状态筛选。

POST /api/v1/cases/upload 上传病例图像

上传超声造影图像至指定病例，支持 JPG/PNG/DICOM 格式。

GET /api/v1/cases/{case_id} 获取病例详情

获取病例完整信息，包括图像、诊断记录、报告等。

⛓️ 区块链存证

POST /api/v1/blockchain/evidence 诊断报告上链存证

基于 FISCO BCOS 区块链，将诊断报告哈希上链存证，确保数据不可篡改、可追溯。

JSON · 请求示例

{
  "diagnosis_id": "D-20260430-001",
  "patient_did": "did:fisco:bcs:0x1234...abcd",
  "report_hash": "0x5678...efgh"
}

🧪 在线调试

需要 API Key

API 端点

API Key

请求体 (JSON)

200 OK ⏱ 245ms

{ "success": true, "message": "请求成功" }

💻 SDK & 工具

🐍

Python SDK

支持 Python 3.8+，异步/同步双模式

安装

pip install aimed-sdk

📦

JavaScript SDK

Node.js / 浏览器端通用

安装

npm install aimed-sdk

📮

Postman 集合

一键导入，快速测试所有 API

⚠️ 错误码参考

状态码	说明	处理建议
200	请求成功	—
400	请求参数错误	检查请求体 JSON 格式和必填字段
401	认证失败	检查 API Key 是否正确、是否过期
429	请求频率超限	降低请求频率，默认限制 60 次/分钟
500	服务器内部错误	联系 admin@aius.xin 反馈