REST API
每个请求都带有 API 密钥或 OAuth 访问令牌。会话就是您自己的一个引擎，拥有独立的文件：上传、运行命令、下载，然后结束它。
https://api.occlusia.app/v1/engine
KEY=occ_sk_… # Account › API keys
API=https://api.occlusia.app/v1/engine
AUTH="Authorization: Bearer $KEY"
JSON="Content-Type: application/json"
# 1. A session: an engine of your own, with its own files
S=$(curl -s -X POST $API/sessions -H "$AUTH" | jq -r .id)
# 2. The model and your graphic standard
curl -T house.skp $API/sessions/$S/files/house.skp -H "$AUTH"
curl -T standard.occc $API/sessions/$S/files/standard.occc -H "$AUTH"
# 3. Open the model (1 credit), apply the configuration (free)
curl $API/sessions/$S/commands/model.open -H "$AUTH" -H "$JSON" -d '{"path":"house.skp"}'
curl $API/sessions/$S/commands/config.set -H "$AUTH" -H "$JSON" -d '{"path":"standard.occc"}'
# 4. Export one view as DXF (1 credit per drawing)
curl $API/sessions/$S/commands/export -H "$AUTH" -H "$JSON" \
-d '{"format":"dxf","sections":"Section A-A","out":"section-a.dxf"}'
# 5. Download it, then end the session: its files are deleted with it
curl -o section-a.dxf $API/sessions/$S/files/section-a.dxf -H "$AUTH"
curl -X DELETE $API/sessions/$S -H "$AUTH"完整的 API 以 OpenAPI 描述，位于 /v1/engine/openapi.json；每条命令及其 JSON Schema 位于 GET /v1/engine/commands。 REST API 指南
Studio、API 和 MCP 背后是同一个引擎
程序得到的，与人在 Studio 中得到的相同：相同的图纸、相同的拒绝情形、相同的价格。API 在
GET /v1/engine 处给出引擎的版本和构建号。- 打开模型
- SketchUp (.skp)、IFC 和 FBX 模型，以及 Occlusia 自有的 .occs 模型和 .occp 项目。
- 读取
- 对象及其分组、视图、注释、标高、图层、线条样式和填充图案预设。
- 设置样式
- 对象、视图、注释或图层的任何设置——或整份 .occc 配置，在应用前先经过检查。
- 预览
- 以 PNG、JPEG 或 SVG 返回视图，长边最多 2048 像素：这是 AI 智能体用来查看的内容。
- 导出
- SVG、DXF、PDF（每个视图一页或合为一份文档，可设纸张、方向和比例）、PNG 和 JPEG。
- Auto config
- Occlusia 根据对象名称提出的配置，在运行前先报价。
MCP 服务器，面向 AI 工具
基于 Streamable HTTP。AI 工具只需要地址：首次使用时，它会引导您到 occlusia.app 进行批准，然后带着令牌返回。无需复制任何密钥。
https://api.occlusia.app/v1/mcp
- Claude
- Settings › Connectors › Add custom connector，然后填入地址。
- ChatGPT
- 添加自定义 MCP 服务器，填入地址，并以 OAuth 作为身份验证方式。
- Cursor、VS Code 及其他
- 添加远程 MCP 服务器（Streamable HTTP）并填入地址：它们会以同样的方式让您登录。
Claude Code：一条命令，然后用 /mcp 登录——对于会发送请求头的工具，也可以改用 API 密钥。
claude mcp add --transport http occlusia https://api.occlusia.app/v1/mcpclaude mcp add --transport http occlusia https://api.occlusia.app/v1/mcp \
--header "Authorization: Bearer occ_sk_…"与 Studio 一样，以点数付费
导出和 Auto config 的费用与在 Studio 中相同。由于 Occlusia 的服务器承担了 Studio 中由您的计算机完成的工作，打开一个模型需要 1 点，每计算一张新图纸需要 1 点；在同一会话中再次计算同一张图纸免费，列出、读取和设置也免费。每个付费的响应都会说明其费用以及之后的余额。
抢先体验期间不扣除任何点数，额度为每个账户在任意 24 小时内最多 500 点的 API 工作。