第 1 步：申请密钥
登录后打开 个人中心 → 开放API密钥，填写备注名称、选择作用域后提交。 明文 Key 只显示一次，请立即复制保存到安全的地方（密码管理器或服务端环境变量）。
作用域建议先填 *（开放全部能力）；生产环境可按最小权限只勾选需要的，例如 zlljs:calc tldb:read。
第 2 步：拉取能力清单
先看看有哪些接口可用——这份清单是服务端自描述的，AI 也靠它发现能力：
curl "https://tool.0cai.net/openapi/v1" -H "Authorization: Bearer YOUR_KEY"
返回示例（节选）：
{
"success": true,
"service": "tool.0cai.net Open API",
"version": "v1",
"base": "https://tool.0cai.net/openapi/v1",
"auth": "Authorization: Bearer <key> 或 X-API-Key: <key>",
"endpoints": [
{ "tool": "zlljs", "action": "calc", "method": ["GET","POST"], "scope": "zlljs:calc",
"summary": "导线载流量计算（GB 50545-2010 摩尔根公式）", ... }
],
"usage": { "quota": { "limit": 1000, "used_today": 3, "remaining": 997 } }
}
第 3 步：调用接口
以最常用的载流量计算为例——只给导线型号就够了，其余参数自动从导线库补全：
curl "https://tool.0cai.net/openapi/v1/zlljs/calc?wire=LGJ-400/50&thetaA=40&thetaB=70&V=0.5" \
-H "Authorization: Bearer YOUR_KEY"
返回（节选）：
{
"success": true,
"I": 590.39, // 允许载流量 A ← 核心结果
"Rdc": 0.0724, "Rac": 0.07554, // 直流/交流电阻
"k1": 1.0189, "k2": 1.0132, // 集肤效应 / 磁滞涡流系数
"WR": 61.2, "WF": 52.8, "Ws": 0, // 辐射 / 对流 / 日照吸热
"wire": { "name": "JL/G1A-400/50 (GB/T 1179-2017)", "S": 451.55, ... }
}
看到
"I": 590.39 就说明整条链路通了。更多语言的完整示例见
代码示例。
