探索 Dlubal API

Dlubal API 是一个可编程接口（应用程序编程接口），可直接访问 Dlubal 软件的功能。目前，API 适用于 RFEM 6 和 RSTAB 9，未来也将支持 RSECTION、RWIND 和在线荷载查询工具。

通过 Dlubal API，您可以高效自动化重复性强且耗时的任务，创建定制化工作流程，并为内部流程及特定客户项目开发个性化解决方案。典型的应用场景包括：自动化建模和数据输入、结构优化的方案对比研究、自定义设计和校核方法，或与其他软件解决方案的接口对接。

此外，API 还能您摆脱 Dlubal 软件用户界面的限制，自由灵活地设计工作流程。您可以编写完全符合自身需求的脚本和程序，并将其无缝整合到现有流程中。

我们很乐意就您的具体需求为您提供个性化咨询服务，并协助您将 API 集成到您的工作流程中。

要使用 Dlubal API，您需要具备以下条件：
1. 有效的 Dlubal 主软件许可证（完整版或试用版），当前支持 RFEM 6 和 RSTAB 9，未来将支持 RSECTION、RWIND 和在线荷载查询工具。
2. 个人 API 密钥。您可以通过您的 Dlubal 外部网账户轻松生成 API 密钥，路径为“API 与云计算 → API II → 我的 API 密钥”：

您无需额外订阅 API 服务，即可直接使用免费的 “Free” 订阅套餐，轻松无忧地体验和使用 API。

新一代 Dlubal API 基于现代的 gRPC 技术，目前主要支持 Python。您可以通过 PyPI 轻松安装官方的 Python 客户端。在 Dlubal API 文档中还提供了大量代码示例，帮助您快速入门。

现已新增支持 C# 客户端，可通过 NuGet 便捷安装使用。

尽管支持多种语言，但我们仍推荐优先使用 Python：上手简单，学习曲线平缓，原型开发速度极快，拥有丰富的第三方库和活跃且庞大的开发者社区。

Dlubal 的新 API 目前支持 RFEM 6、RSTAB 9 和 RSECTION 1。未来它也将适用于 RWIND 以及 Geo-Zonen-Tool。兼容的版本包括完整版软件许可证、高校和学生许可证以及试用版本。目前正在准备对演示版本的支持。

Dlubal API 会定期随所支持的主程序（目前为 RFEM 6 和 RSTAB 9，未来包括 RSECTION 和 RWIND）一同更新，以确保功能匹配与系统兼容性。为了获得最佳兼容性，我们建议您始终使用与已安装主程序的次版本号和修订号相对应的 API 版本。例如：如果您使用的是 RFEM 版本 6.10.0007，那么应配套使用 API 版本 2.10.7。

Dlubal API 会不断扩展和优化。为了确保您始终使用最新版本并及时了解新增功能或修复更新，建议您定期查阅官方 Dlubal API 文档“发布”中的更新日志。

即将推出的 Dlubal MCP Server 目前正在积极开发中，目标是通过人工智能技术，实现对 RFEM 和 RSTAB 所有数据和功能的智能化访问。作为一款面向服务的中间件，它在您的应用程序与 Dlubal 软件 RFEM 或 RSTAB 之间搭建了一座桥梁。其核心理念由三大部分构成：

1. 开放 API 层 – 通过清晰文档化的 REST 和 WebSocket 接口，封装了所有模型、结果和设计功能。这使您能够完全跨平台访问 RFEM/RSTAB。

2. 实时数据总线 – 模型变更以及所有相关的 RFEM/RSTAB 数据（包括荷载工况、内力或设计结果）— 会被实时流传输。外部系统可即时获取这些数据，自动启动计算或触发其他操作。

3. AI 智能协调层 – 内置 AI 引擎能将自然语言输入或优化任务自动转换为相应的 API 请求，就像您与我们的 AI 助手米娅对话一样。例如：

• 在节点 5 和 8 之间创建一个新的 S235 钢杆件，截面为 IPE 200。
• 给我杆件编号 12 在荷载工况编号 5 下的所有内力。
• 找出模型中最危险（临界）的杆件。
• 在 HEA 截面系列中找出对于杆件编号 21 利用率最高的截面。
• 导入 DXF 文件 xxxxx.dxf 作为背景图层。
• 通过宽度、高度、深度、屋顶坡度等对三维厂房结构进行建模。

所有这些操作，MCP 服务器都能自动地在模型中完成。

简而言之：即将推出的 Dlubal MCP 服务器将成为新一代开放互联结构分析世界的核心枢纽。其背后的模型上下文协议(MCP)是一种开放标准，用于将 AI 模型与外部工具和数据源连接。借助 MCP，未来可以仅用几行代码就能将 RFEM 或 RSTAB 接入几乎任何应用程序。无论是 CAD 和 BIM 软件、个性化仪表盘，还是企业级微服务。

借助 MCP，结构计算、数据分析与 AI 自动化将首次真正实现在一个统一流程中无缝集成。这不仅仅是一个新功能，更是一场划时代的飞跃，开启无边界工程的新时代，让您的创意比以往任何时候都更快成为现实。

所有对模型进行主动更改、触发计算、获取结果或保存模型的操作均视为 API 请求。其中包括模型修改、执行计算和结果查询等操作。而诸如查询当前账单信息等“服务”类型的管理操作，则不计入 API 请求。

API 请求的数量与您的 API 订阅相关，因为根据所选订阅，每个计费周期都有特定的请求额度。

活跃用户是指在一个计费周期内至少通过 API 发起过一次请求的用户。无论该用户使用多少个 API 密钥，在同一个计费周期内都只计算为一名用户。

为了更清晰透明地监控 API 的使用情况，我们建议您为不同项目或用户分别创建 API 密钥。这样可以帮助您更精准地评估和分析各自的 API 使用情况。

Dlubal 始终重视信任与透明度。您可以在个人的 Dlubal 外部网账户中的“API 与云计算 → API II”页面，查看统计表格，轻松掌握您的 API 请求记录、会话情况，以及在指定时间段内的请求数量。

• Dlubal 外部 | API II | API 请求 | 我的
• Dlubal 外部网 | API II | API 请求计数 | 我的

您可以在我们的网站上找到全面的 API 文档，包括详细的方法说明、实用的应用示例和清晰的安装指南。请访问我们的网站：

该文档有助于您快速熟悉并高效使用 API。我们的代码示例库正在不断扩充和优化。此外，我们目前正在开发一个网络社区平台，Dlubal 用户可以在此平台上积极交流使用经验，并分享技巧、解决方案以及提问。

我们还提供大量关于 API 的网络研讨会，让您了解实际应用场景并获得宝贵的见解。

有关安装、连接或错误消息的问题，您可以在我们官网的支持与 FAQ 版块找到解答和帮助：

• 常见问题 (FAQ)

对于更为复杂的问题、个性化需求或开发支持，我们为您提供量身定制的培训和咨询服务。

此外，我们即将推出全新的 Dlubal 社区平台。您可以在社区与其他用户交流，分享经验，共同开发解决方案。社区的优势在于通过集体智慧和直接沟通，提供快速的支持。

我们的 AI 助手米娅还可以全天候为您服务。她专门接受了Dlubal API 相关知识的训练，能够随时快速、简便地为您提供合适的解决方案和信息。

gRPC 是一种现代且开源的通信技术，专为应用程序之间实现高速且可靠的数据交换而设计。其核心优势是高效性 — gRPC 的通信技术可以比传统的 SOAP 或 REST 快达15倍。

作为用户，您无需掌握 gRPC 的专业知识，因为所有技术细节已经集成在由 Dlubal 提供的客户端中。您可以自动享受到 gRPC 技术带来的速度和可靠性。

统一 API 帮助您大幅提升效率，因为它……

• 节省时间 — 自动完成模型构建、荷载分配和结果分析，大大缩短设计周期。
• 降低成本 — 减少手动操作，节省工程工时，从而降低项目成本。
• 完全可定制 — 根据项目或企业的要求，精确设计计算、报告和工作流程，不受用户界面的限制。
• 无缝集成 — 实现 RFEM、RSTAB 等软件与 BIM 和 CAD 工具的双向连接，避免信息断层，确保数据一致。
• 全面数据访问 — 访问所有模型对象和结果，精准筛选并进一步处理数据，基于数据做出决策。
• 释放创新潜力 — 支持开发新应用、原型和 AI 工作流（例如使用 AI 助手米娅），让创新更高效。
• 高效传输 — 采用 gRPC 技术，数据传输速度比传统的 SOAP/REST 服务快 10 倍。

Dlubal 推荐使用 Visual Studio Code 作为 API 编程的开发环境 (IDE)。Visual Studio Code 功能强大、免费且开源，特别是其可扩展性极为出色。您可以安装众多扩展来进一步提高编程效率 — 例如，Cline AII 扩展，支持 AI 智能编程，进一步优化您的工作流程。

• Cline AI：协作式 AI 编码器