🚀 开始使用 TCMOI
5分钟快速上手，开启中医药AI开发之旅
1
📝 注册账号并获取API密钥
使用GitHub账号或邮箱注册，即可自动获得免费API密钥。所有新用户默认享有基础调用额度。
✨ 注册方式：
• GitHub OAuth：点击“使用GitHub登录”，一键授权完成注册
• 邮箱注册：输入邮箱和密码，验证后即可使用
• 学术机构：使用.edu邮箱注册可自动升级额度
• GitHub OAuth：点击“使用GitHub登录”，一键授权完成注册
• 邮箱注册：输入邮箱和密码，验证后即可使用
• 学术机构：使用.edu邮箱注册可自动升级额度
🔑 示例API密钥（注册后获得）：
tcmoi_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ 请妥善保管您的API密钥，不要分享给他人或上传到公开仓库
2
📦 安装Python SDK
TCMOI提供官方Python SDK，支持一键安装，开箱即用。
pip install tcmoi-sdk
📋 系统要求：
• Python 3.8 及以上版本
• 支持 Windows / macOS / Linux
• 建议使用虚拟环境（venv 或 conda）
• Python 3.8 及以上版本
• 支持 Windows / macOS / Linux
• 建议使用虚拟环境（venv 或 conda）
# 创建虚拟环境（推荐）
python -m venv tcmoi-env
source tcmoi-env/bin/activate # Linux/macOS
# 或 .\tcmoi-env\Scripts\activate # Windows
# 安装SDK
pip install tcmoi-sdk
3
🎯 第一个API调用
使用您的API密钥，调用TCM-BERT辨证模型。
from tcmoi import TCMClient
# 初始化客户端
client = TCMClient(api_key="your_api_key_here")
# 调用辨证模型
result = client.syndrome_classify(
text="恶寒发热，头痛无汗，周身酸痛，舌淡苔白"
)
print(result)
✅ 预期输出：
{
"syndromes": [
{"name": "风寒束表", "probability": 0.87},
{"name": "风热犯卫", "probability": 0.09},
{"name": "其他", "probability": 0.04}
],
"suggested_formula": "麻黄汤加减",
"confidence": 0.86
}
💡 提示： 首次调用可能需等待几秒加载模型，后续请求将更快响应。
4
📚 更多示例
探索TCMOI平台的其他功能，快速集成到您的应用中。
# 药靶预测
result = client.herb_target_predict(herb="丹参")
# 方剂推荐
result = client.formula_recommend(syndrome="气阴两虚")
# 知识图谱查询
result = client.kg_query(entity="麻黄", relation="配伍禁忌")
# 文献实体抽取
result = client.extract_entities(text="黄芪通过PI3K/AKT通路改善糖尿病肾病")
💰 定价与额度
🎓 教育优惠： 学生和教师使用.edu邮箱注册，自动升级至科研版额度，永久免费。
立即验证学术身份 →
立即验证学术身份 →
❓ 常见问题
Q: 如何获取API密钥？
注册账号后，登录控制台即可在「API管理」页面查看您的密钥。新用户自动获得免费额度。
Q: 免费额度用完后怎么办？
可以等待次日重置，或升级到付费计划。学术用户可申请免费扩展额度。
Q: 模型能否用于商业项目？
所有模型采用Apache 2.0协议，可免费商用。API调用需根据使用量付费。
Q: 数据隐私如何保障？
平台不存储用户输入的文本数据，API日志保留30天后自动删除，详见隐私政策。
Q: 支持哪些编程语言？
官方支持Python SDK，同时提供RESTful API，任何语言均可调用。
Q: 如何获取技术支持？
通过Discord社区、GitHub Issues或邮件 support@tcmoi.com 联系我们。