舌诊开放平台 · 正式开放接入

让你的应用
5 分钟拥有 AI 舌诊能力

标准 RESTful 接口，结构化辨证 JSON 直接返回。百万级舌象样本训练，覆盖 9 大体质 + 主流证候，让每一份健康报告都有据可依。

100万+
舌象样本训练
6 大
舌象维度结构化
4 种
语言输出支持
99.5%
服务可用性 SLA

为什么选择新享舌诊开放平台

从一张舌象图，到一份可落地的中医辨证报告

极简接入 · 一杯咖啡的时间

3 步上线：申请 API Key → 上传舌象 → 拿到结构化 JSON。3 个核心接口覆盖完整诊断流程，无需自建模型、无需训练。

结构化辨证 · 数据可二次开发

舌色/苔色/苔质/舌形/津液/舌下络脉 6 维 + 体质识别 + 证候诊断 + 鉴别诊断 + 置信度，每个字段附 evidence 证据链。

智能问诊补辨 · 结论不打折

置信度不足时模型自动发起结构化问诊（单选/多选 + 自由文本），用户回答后整合输出，结论更稳健，避免"拍脑袋"。

多语言出参 · 覆盖海外市场

中文、英文、日文、韩文一键切换，整份 JSON 完整本地化。海外华人养生、东亚中医出海，开箱即用。

个性化保健建议 · 闭环用户价值

基于辨证结果生成穴位、中药、饮食、运动 4 类目个性化方案，每条建议附经络归属、操作手法、宜忌理由，可直接落地。

企业级安全 · 多隔离

独立 API Key + 配额管理 + 调用审计，数据全程加密传输。

3 步接入，开始你的第一次调用

最快 5 分钟跑通完整流程

1

申请 API Key

微信扫码联系商务，5 分钟开通，赠送测试调用额度，立刻可用。

2

上传舌象图片

POST /v1/diagnose/start，文件或 URL 均可，支持舌面 + 舌下多张一次提交。

3

拿到结构化 JSON

直接出结论或追问问诊后整合输出，再调用保健建议接口完成业务闭环。

谁在使用舌诊开放平台

把 AI 舌诊嵌入你的产品，从体验升级到商业闭环

健康类 APP / 小程序

为用户提供"拍舌头知体质"的轻量入口，提升 DAU 与留存。结构化 JSON 直接渲染体质卡片、健康趋势图。

体质打卡 健康日历 付费会员

智能舌诊一体机

健康屋、康养社区、医院自助机的核心 AI 大脑。本地相机采集 + 云端接口分析，秒级出报告。

硬件 OEM 触屏交互 报告打印

养生连锁 SaaS

门店技师手机一拍，到岗前已生成方案。差异化服务能力，让客单价和复购率同步抬升。

服务前评估 个性化套餐 效果追踪

中医诊所信息化

辅助医师诊前预判，结构化数据沉淀到 HIS，长期建立患者舌象趋势档案。problem-driven 不替代医师，只为医师加速。

辅助辨证 病历归档 疗效追踪

微信公众号 / H5

不用 APP 不用下载，公众号菜单一键拉起 H5，扫码即用。轻量获客、低门槛体验，传播裂变首选。

活动获客 社群转化 公众号涨粉

保险 / 体检中心

体检套餐增项、保单核保前置评估，把中医视角的健康画像融入主流健康风险评估体系。

增值服务 健康画像 差异化定价

接口文档

4 个核心接口 · 一份请求 = 一份完整中医辨证报告

请求状态机

模型一次决定走向，前端无需复杂状态管理

路径 A 直接出结论

模型对舌象置信度足够 → status=completed + 完整 JSON，一次调用即可。

路径 B 问诊后出结论

置信度不足 → pending_inquiry + 1~8 个追问问题，调 /reply 提交答案后整合输出。

路径 C 非舌象兜底

上传不是舌头（人脸/风景/文字）→ HTTP 422 + 明确错误原因，避免无效计费。

5 分钟跑通第一次调用

复制示例代码，替换 API Key，即可开跑

curl -X POST https://agent.xxyc.tech/v1/diagnose/start \
      -H "Authorization: Bearer tk_your_api_key_here" \
      -F "images=@tongue_front.jpg" \
      -F "images=@tongue_sublingual.jpg" \
      -F "patient_info={\"gender\":\"female\",\"age\":32}" \
      -F "language=zh-CN"
POST

/v1/diagnose/start

计费

发起一次舌诊。上传舌象图片（支持多张），可选传入患者信息、问诊模式、输出语言。

请求参数

参数类型必填说明
image_urlsstring[]是*公网可访问的图片 URL
patient_infoJSON是患者信息：gender / age 等
inquiry_modestring否auto（默认）/ enable（强制问诊）/ disable（仅舌象）
languagestring否zh-CN（默认）/ en / ja / ko

响应示例（直接出结论）

{
      "diagnosis_id": "9b1f...c3",
      "status": "completed",
      "result": {
        "tongue_color":    { "value": "淡红", "severity_score": 2.1, "evidence": "舌质偏淡，边缘略有齿痕" },
        "coating_color":   { "value": "薄白", "severity_score": 1.8 },
        "coating_texture": { "value": "薄",   "severity_score": 3.4 },
        "tongue_shape":    { "value": ["胖大", "齿痕"], "severity_score": 5.1 },
        "constitution": { "primary": { "name": "气虚质", "confidence": 0.86 } },
        "syndrome":     { "primary": { "name": "脾气虚证", "confidence": 0.84 } },
        "confidence": 0.84
      }
    }
POST

/v1/diagnose/:id/reply

计费

当模型发起问诊（status=pending_inquiry）时，提交用户回答以获取最终诊断结果。同一诊断只能回复一次。

问诊问题（首轮返回）

{
      "diagnosis_id": "9b1f...c3",
      "status": "pending_inquiry",
      "follow_up_questions": [
        {
          "text": "您是否容易疲劳，并且饭后明显困倦？",
          "options": ["完全没有", "偶尔", "经常", "持续如此"],
          "multi": false,
          "allow_other": false
        }
      ]
    }

提交答案请求体

{
      "answers": [
        {
          "question": "您是否容易疲劳...",
          "selected": ["经常"]
        },
        {
          "question": "您目前的表现?(可多选)",
          "selected": ["怕冷", "口干"],
          "other": "晨起腰酸"
        }
      ]
    }
GET

/v1/diagnose/:id

免费查询

查询诊断状态与结果。支持轮询或异步回调场景，不消耗调用配额。

响应字段

字段说明
statuscompleted / pending_inquiry / failed
final_result完整辨证 JSON（仅 completed 时有值）
inquiry_mode本次诊断的问诊模式
language本次诊断的输出语言
created_at / completed_at诊断创建 / 完成时间（ISO 8601）
POST

/v1/diagnose/:id/health-advice

计费

基于已完成诊断生成个性化保健建议，支持 4 个类目按需组合：穴位 / 中药 / 饮食 / 运动。

请求体

{
      "categories": [
        "acupoint",
        "medication",
        "diet",
        "exercise"
      ]
    }

响应示例（节选）

{
      "summary": "脾虚湿盛 + 痰湿质：健脾化湿、行气化痰",
      "acupoint": {
        "points": [{
          "name": "足三里",
          "meridian": "足阳明胃经",
          "location": "外膝眼下 3 寸",
          "method": "拇指按揉 3~5 分钟，每日 1~2 次"
        }]
      },
      "diet": { "recommended": [...], "avoid": [...] }
    }

Bearer Token 鉴权

所有接口使用 Bearer Token，请求头携带 API Key 即可。

HTTPS 全程加密 配额可控 调用审计

Request Header

Authorization: Bearer tk_xxxxxxxxxxxx

输出结构

标准 JSON 格式 · 6 大舌象维度 + 体质 / 证候 / 鉴别诊断 + 保健建议

舌象观察 · 6 大维度

每个维度返回 value（取值）+ severity_score（异常程度 0-10）+ evidence（证据描述）

舌色

tongue_color

反映气血盛衰、寒热虚实

淡白 淡红 红 绛红 紫暗

苔色

coating_color

辨外感寒热、内伤虚实

白 黄 灰黑 无苔

苔质

coating_texture

辨胃气存亡、湿浊轻重

薄 厚 腻 腐 剥落

舌形

tongue_shape

支持多值（数组），刻画虚实兼夹

胖大 瘦薄 齿痕 裂纹 芒刺

津液

moisture

观津液盈亏、阴阳偏盛

润 滑 燥 干裂

舌下络脉

sublingual_veins

察血瘀程度，心脑血管参考

正常 迂曲 怒张 色青紫

辨证结论 · 主次有别 + 置信度可量化

9 大体质 + 主流证候识别，附鉴别诊断与推理链

体质辨识

primary + secondary[]，含 reasoning 推理与 confidence 置信度

平和质 气虚质 阳虚质 阴虚质 痰湿质 湿热质 血瘀质 气郁质 特禀质

证候诊断

primary + secondary[]，附 differential_diagnosis 鉴别诊断

脾气虚证 肝郁气滞 湿热下注 阴虚火旺 心脾两虚 气滞血瘀 …

置信度量化

所有结论均带 0-1 之间的 confidence，业务侧可据此分流

  • · severity_score：维度异常程度（0-10）
  • · confidence：辨证结论置信度
  • · 含 inquiry_integration 问诊整合

个性化保健建议 · 4 类目可按需组合

基于辨证结论二次生成，紧扣主证主体质，每条建议可直接落地执行

穴位 acupoint

3~6 个

经络归属、定位、按压手法、频次、注意事项

中药 medication

公开方剂 + 单味药

适应证、用法用量、配伍、禁忌人群提示

饮食 diet

宜 / 忌 + 食谱

推荐食材含理由、忌口含原因，附完整食谱配方

运动 exercise

1~4 项

功法类型、时长、强度、原理与避免事项

查看完整响应 JSON 示例

点击展开 · 真实接口返回结构

{
      "diagnosis_id": "9b1f5e2c-...-c3",
      "status": "completed",
      "result": {
        "reasoning": "舌质淡红偏胖，苔薄白略腻，结合齿痕与舌下络脉迂曲，提示脾虚兼湿浊内停...",
        "tongue_color":    { "value": "淡红",       "severity_score": 2.1, "evidence": "舌质偏淡，边缘可见齿痕" },
        "coating_color":   { "value": "薄白",       "severity_score": 1.8, "evidence": "苔色淡白，分布均匀" },
        "coating_texture": { "value": "薄腻",       "severity_score": 4.2, "evidence": "苔薄但略显腻滑" },
        "tongue_shape":    { "value": ["胖大", "齿痕"], "severity_score": 5.1, "evidence": "舌体胖大，边缘齿痕明显" },
        "moisture":        { "value": "润",         "severity_score": 1.8, "evidence": "舌面津液适中" },
        "sublingual_veins":{ "value": "轻度迂曲",   "severity_score": 3.9, "evidence": "左侧脉络略迂曲" },
        "constitution": {
          "primary":   { "name": "气虚质", "reasoning": "舌淡胖大有齿痕、舌下脉迂曲", "confidence": 0.86 },
          "secondary": [{ "name": "痰湿质", "reasoning": "苔薄腻", "confidence": 0.62 }]
        },
        "syndrome": {
          "primary":   { "name": "脾气虚证",   "reasoning": "舌淡胖齿痕 + 苔薄腻，符合脾气虚兼湿", "confidence": 0.84 },
          "secondary": [{ "name": "脾虚湿盛", "reasoning": "苔腻提示湿浊未化",                    "confidence": 0.71 }]
        },
        "confidence": 0.84,
        "differential_diagnosis": [
          { "name": "肾阳虚证", "reason": "无明显畏寒肢冷舌淡白胖嫩等典型表现，暂不考虑" }
        ],
        "notes": "建议结合症状与脉诊综合判断，必要时由中医师面诊确认"
      },
      "created_at":   "2026-05-15T14:32:18Z",
      "completed_at": "2026-05-15T14:32:48Z"
    }
免费试用额度
开通即送测试调用
5 分钟接入
3 个接口跑通业务
99.5% SLA
企业级稳定保障
专属技术支持
微信群答疑响应

立即开始你的舌诊之旅

三种方式任你选择 · 总有一种适合你

最便捷

公众号 H5 体验

关注「新享服务」公众号，菜单一键拉起在线舌诊，拍照即出报告。无需开发，3 秒上手。

新享服务公众号二维码

新享服务

推荐
最推荐

申请 API Key 接入

商务对接，5 分钟开通，赠送测试额度。技术拉群专属答疑，让你的产品快速拥有 AI 舌诊能力。

  • 独立 API Key · 配额可控
  • 支持公有云 / 私有化
  • 白名单 / 定制功能
最深入

下载技术文档

完整接口规范、错误码、最佳实践、状态机说明。让你的工程团队 1 天内完成 POC 验证。

OpenAPI 接口规范
多语言示例代码
常见错误与排查指南

常见问题

技术、商务、合规相关的高频问答

Q：申请 API Key 需要多久？是否收费？
商务沟通后 5 分钟即可开通，开通即赠送测试调用额度。试用期免费，达到生产用量后按调用次数计费，提供多档套餐与年付优惠。
Q：返回的辨证结论可以直接给用户看吗？合规吗？
建议以"AI 健康参考 / 体质评估"形式展示，不替代临床诊断。所有保健建议都包含 disclaimer 字段提醒用户"仅供参考、需由执业中医师面诊"。我们会协助你设计合规的页面文案与展示规范。
Q：能否针对我们的业务做定制？
可以，如有专属术语词典、私域知识、设备 OEM 需求，欢迎联系商务深聊。
商务通道 · 24h 内响应

准备好让你的产品
拥有 AI 舌诊能力了吗？

微信扫码联系商务，我们会用 5 分钟为你开通，附赠测试调用额度、技术接入文档、接入答疑微信群，让你的工程师马上开干。

商务电话：17761729879
商务邮箱：service@xxyc.tech
商务微信二维码

微信扫一扫

添加商务，获取 API Key