MedicalKnow-健康图谱API

一、接口说明

接口名称：MedicalKnow

能力说明：

• 基于权威的医疗数据，面向医疗类实体的属性查询（例如「阿莫西林胶囊」「阿司匹林」「苹果热量」「高血压」），相对其他搜索 API 而言可以获取更多、更全面的医疗信息。

• 返回内容为实体及其属性的结构化文本，适合作为药品、病症、食品的结构化知识底座；「哪家好」这类主观评价或推荐类问句不在本接口能力范围内，会返回空 messages，此类问题建议改用医疗问答 API。

计量方式为「垂域搜索」，按次计费，单价详见 垂域搜索-计费说明。

二、接口定义

三、示例

{
  "query": "阿莫西林胶囊",
  "type": "medicine"
}

{
  "requestId": "d3c1b3*********cdebe",
  "messages": [
    {
      "url": "https://p.example.cn/0387f345/index?struct_id=VdB%2BLV7w7lHHEp",
      "content": "实体：阿莫西林胶囊\n- 属性[精确活性成分]：阿莫西林\n- 属性[生产剂型]：口服用胶囊\n- 属性[适应症]：阿莫西林属于青霉素类抗生素，有较强的杀菌作用……\n- 属性[药理作用]：阿莫西林可通过抑制细菌细胞壁合成而发挥杀菌作用。"
    }
  ],
  "searchInformation": {
    "searchTime": 308
  },
  "queryContext": {
    "originalQuery": {
      "query": "阿莫西林胶囊"
    }
  }
}

四、接口调用

使用产品的凭证（API-KEY）进行认证。API-KEY 在控制台「创建、查看凭证 Key」中创建， 创建后需等待约 5 分钟生效 。

curl -X POST https://cloud-iqs.aliyuncs.com/medical/know \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "阿莫西林胶囊",
    "type": "medicine"
  }'

本接口仅提供 HTTP 直接调用，不提供阿里云 OpenAPI SDK。MCP / Skill 接入方式请参考「接入方式」章节。

五、错误码

调用失败时返回 HTTP 非 2xx 状态码，响应体为扁平结构。errorCode 与 errorMessage 恒定返回，部分错误会同时返回含义相同的 code 与 message 字段，解析时以 errorCode 为准：

{
  "errorCode": "Retrieval.EngineNotActivate",
  "errorMessage": "Please activate medicalKnowSearch.",
  "code": "Retrieval.EngineNotActivate",
  "message": "Please activate medicalKnowSearch."
}

相关文档

• 垂域搜索-产品介绍

• 垂域搜索-计费说明