zzkj-chat 智能问诊 API 使用文档
基于智诊科技 WiseDiag 智能体工作流的智能问诊接口，通过 DMXAPI /v1/responses 端点提供个性化健康咨询与建议。接口支持流式输出、健康档案个性化、多语言（zh / en / id / ar 等）、多轮对话上下文管理（topic_id），并集成本地知识库、专家知识库、中医知识库与医学专网搜索四大知识源，结合查询理解分析能力，可输出包含推理过程与商品推荐的结构化健康指导内容。
🚀 请求地址
https://www.dmxapi.cn/v1/responsesWARNING
请妥善保管您的 API Key！严禁将密钥泄露给他人、硬编码到代码中或提交到公开的代码仓库。如果怀疑密钥已泄露，请立即前往 DMXAPI 官网重新生成。
🧠 模型名称
zzkj-chat
💬 智能问诊示例代码
python
import requests
import json
import time
# ═══════════════════════════════════════════════════════════════
# 步骤1: 配置 API 连接信息
# ═══════════════════════════════════════════════════════════════
# DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"
# DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-*************************************************"
# ═══════════════════════════════════════════════════════════════
# 步骤2: 配置请求头
# ═══════════════════════════════════════════════════════════════
headers = {
"Content-Type": "application/json", # 指定请求体为 JSON 格式
"Authorization": f"{api_key}", # token 认证方式
}
# ═══════════════════════════════════════════════════════════════
# 步骤3: 配置请求参数
# ═══════════════════════════════════════════════════════════════
payload = {
# 【model】(string, 必填) 模型名称
# 固定值: "zzkj-chat"
"model": "zzkj-chat",
# 【task_name】(string, 必填) 任务类型标识
# 可选值: "chat"(智能问诊聊天，提供个性化健康咨询与建议)
# / "photo_read"(图片健康解读，智能分析医学影像与健康相关图片)
# / "calories"(热量识别，识别食物并计算营养成分)
# 本示例使用 chat 任务进行智能问诊
"task_name": "chat",
# 【input】(array, 必填) 消息数组（对应官方文档 messages 字段）
# 格式: [{"role": "user", "content": "..."}]
# 若不传入 system 消息，将使用内置默认 system 提示词
# 当 topic_id 已传入时,仅需传入一轮 user prompt,系统会自动管理上下文
"input": [
{"role": "user", "content": "我平时饮食中需要注意什么?"}
],
# ───────────────────────────────────────────────────────────
# 会话管理
# ───────────────────────────────────────────────────────────
# 【topic_id】(string, 可选) 会话 ID，用于上下文管理
# 使用说明:
# - 不传入时: 不进行会话管理，需客户端自行拼接多轮对话
# - 传入时: 自动管理会话上下文，每次仅需传入一轮 user prompt
# - 传入新 system 时: 该 topic 整组会话的 system 将被更新
"topic_id": "demo_chat_001",
# 【request_id】(string, 可选) 请求唯一标识
# 建议使用毫秒级时间戳: str(int(time.time() * 1000))
# 不传入时将自动生成
"request_id": str(int(time.time() * 1000)),
# 【user_id】(string, 可选) 用户唯一标识
# 用于区分不同终端用户的请求
"user_id": "test_user_001",
# ───────────────────────────────────────────────────────────
# 健康档案
# ───────────────────────────────────────────────────────────
# 【member_id】(string, 可选) 健康档案 ID
# 示例值: "sample_1"
# 启用健康档案需同时满足: use_health_record=1 且 member_id 有效
"member_id": "sample_1",
# 【use_health_record】(integer, 可选) 是否启用健康档案
# 默认值: 1
# 可选值: 1(启用，AI 将结合用户档案信息提供个性化建议) / 0(关闭)
"use_health_record": 1,
# ───────────────────────────────────────────────────────────
# 知识库与检索（query_understand=1 时，至少开一个知识源）
# ───────────────────────────────────────────────────────────
# 【query_understand】(integer, 可选) 是否进行查询理解分析
# 默认值: 1
# 可选值: 1(启用查询理解) / 0(关闭查询理解)
# 联动规则:
# - 设为 1 时: 必须至少启用一个知识源(local_DB / expert_DB / web_engine),否则不会生效
# - 设为 0 时: 所有知识库参数将自动关闭,即使设置为 1 也不会生效
"query_understand": 1,
# 【local_DB】(integer, 可选) 是否使用本地知识库
# 默认值: 1
# 可选值: 1(使用) / 0(不使用)
"local_DB": 1,
# 【use_ch_medicine】(integer, 可选) 是否启用中医知识库
# 默认值: 1
# 可选值: 1(启用) / 0(关闭)
# 注意: 需同时启用 local_DB 才能生效
"use_ch_medicine": 1,
# 【expert_DB】(integer, 可选) 是否使用专家知识库
# 默认值: 1
# 可选值: 1(使用) / 0(不使用)
"expert_DB": 1,
# 【web_engine】(integer, 可选) 是否开启医学专网搜索
# 默认值: 1
# 可选值: 1(开启) / 0(关闭)
"web_engine": 1,
# ───────────────────────────────────────────────────────────
# 其他
# ───────────────────────────────────────────────────────────
# 【product_open】(integer, 可选) 是否开启商品推荐
# 默认值: 1
# 可选值: 1(开启，响应中会包含商品推荐内容) / 0(关闭)
"product_open": 1,
# 【language】(string, 可选) 语言代码
# 默认值: "zh"
# 可选值: "zh"(中文，所有功能完整支持)
# / "en"(英文，仅支持聊天任务)
# / "id"(印尼语，仅支持聊天任务)
# / "ar"(阿拉伯语，仅支持聊天任务)
# 注意: 非中文语言仅支持聊天任务(task_name="chat")
"language": "zh",
# 【stream】(boolean, 可选) 是否启用流式输出
# 可选值: True(启用流式，按 OpenAI Responses streaming 标准事件转发)
# / False(非流式，一次性返回完整结果)
# 智能问诊接口推荐使用流式输出，便于实时接收 AI 响应内容
"stream": True,
}
# ═══════════════════════════════════════════════════════════════
# 步骤4: 发送请求并输出结果
# ═══════════════════════════════════════════════════════════════
# 发送 POST 请求到 API 服务器（流式）
usage = None
with requests.post(url, headers=headers, json=payload, stream=True) as response:
if response.status_code != 200:
print(f"请求失败,状态码: {response.status_code}, {response.text}")
else:
for line in response.iter_lines():
if not line:
continue
raw = line.decode("utf-8")
# DMXAPI /v1/responses 在 stream:true 下按 OpenAI Responses streaming
# 标准事件转发：每个事件含两行—"event: response.xxx" 与 "data: {...}"，
# 客户端只看 data: 行，跳过 event: 行
if not raw.startswith("data:"):
continue
data_str = raw[5:].strip()
if data_str == "[DONE]":
break
try:
evt = json.loads(data_str)
except json.JSONDecodeError:
continue
t = evt.get("type", "")
if t == "response.output_text.delta":
# 文本片段在 delta 字段（不是 content / reasoning_content）
print(evt.get("delta", ""), end="", flush=True)
elif t == "response.completed":
# usage 嵌在 response 对象里（不是事件顶层）
usage = (evt.get("response") or {}).get("usage")
print()
if usage:
print(f"\n=== Usage ===")
print(json.dumps(usage, indent=2, ensure_ascii=False))📦 返回示例
康小鹿，你好！结合你的类风湿关节炎（RA）情况、海鲜牛奶过敏史以及偏低的BMI（17.3），我为你整理了一份**专属且实用的饮食指南**。核心原则就是：**均衡营养、抗炎优先、个性化调整**。
以下建议综合参考了《中国类风湿关节炎诊疗指南》、《基层医疗机构类风湿关节炎分级诊疗管理专家共识》等权威内容，并特别考虑了你的个人情况。
---
### 你的专属饮食重点清单
**1. 核心多吃：抗炎好伙伴**
* **地中海饮食模式**：这是被国际指南一致推荐的"黄金标准"。多摄入：
* **新鲜蔬果**：尤其是深色蔬菜（菠菜、西兰花）和富含抗氧化剂的水果（蓝莓、草莓、柑橘类），它们能有效对抗炎症。
* **优质蛋白**：由于牛奶过敏，可选择**豆制品**（豆腐、豆浆）、**禽肉**（鸡、鸭）和**淡水鱼**（注意避开海鲜）。这些是修复组织和维持肌肉的重要来源，对你的体重管理也很关键。
* **健康脂肪**：**特级初榨橄榄油**、**坚果**（核桃、杏仁）是很好的选择，它们含有对关节有益的不饱和脂肪酸。
**2. 需要限制或避免：炎症小帮凶**
* **严格忌口过敏原**：海鲜和牛奶是你的明确过敏源，务必完全避免，以免诱发或加重炎症反应。
* **减少促炎食物**：
* **高盐食物**：过多的盐会加重关节肿胀，少吃腌制食品、加工肉类。
* **红肉及加工肉**：如牛肉、猪肉、香肠等，可能增加炎症水平。
* **反式脂肪和饱和脂肪**：常见于油炸食品、快餐、糕点等。
* **精制糖和含糖饮料**：如蛋糕、糖果、汽水等，可能加剧炎症。
**3. 结合你个人情况的特别提醒**
* **增重与营养补充**：你的BMI（17.3）偏低，说明你需要**适当增加营养摄入**。可以在医生指导下，通过健康的加餐（如坚果、酸奶替代品）来增加热量和优质蛋白，为每天爬100层楼梯提供充足能量。
* **酒精**：虽然研究显示适量红酒可能对部分RA患者有益，但**过量饮酒绝对有害**，会加重肝脏负担（尤其在服用艾拉莫德片时），并可能与药物产生相互作用。建议尽量不喝。
* **烹饪方式**：优先选择**蒸、煮、炖、凉拌**等清淡的烹饪方法，避免油炸、烧烤。
**4. 不要忘记的"健康生活组合拳"**
饮食只是其中一环，RA的管理需要多管齐下：
* **规律运动**：像你这样坚持爬楼梯非常好！在非急性期，适度的有氧运动和关节功能锻炼（如游泳、太极）能增强体质、保护关节功能。但记得运动要循序渐进，感觉不适就休息。
* **心理调适**：我知道家庭环境带来的压力让你有持续性焦虑，这真的会影响病情。请一定要重视心理健康，可以尝试冥想、深呼吸，或者和信任的朋友聊聊，必要时寻求专业心理咨询。心情好，身体也会更轻松！
---
**总结一下你的专属饮食口诀**：**多吃蔬果豆蛋鱼，少碰盐糖油炸辣；严格忌口海鲜奶，清淡烹饪最相宜。**
记住，没有一种食物能"治愈"RA，但长期坚持健康的饮食习惯，就像给身体筑起一道"抗炎防线"，会让你感觉更舒服，也能更好地配合药物发挥效果。如果你对某种具体食物不确定，随时可以来问我！加油，好小伴会一直陪着你！💪
=== Usage ===
{
"input_tokens": 0,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens": 1157,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 1157
}© 2026 DMXAPI zzkj-chat 智能问诊