CLIENT GUIDE
API 与证书帮助
申请页、AI 工作台和 API 使用同一个局域网 HTTPS 地址。
1. 建立证书信任
首次访问可能仍有 HTTPS 警告。先通过可信渠道向管理员核对 SHA-256 指纹,再安装下载的证书。如果浏览器阻止下载,可请管理员通过 AirDrop 或其他可信渠道发送证书。
- iPhone 使用
IntelligenceGuider-Root-CA.cer,按系统提示安装。 - 打开「设置 → 通用 → 关于本机 → 证书信任设置」。
- 开启对 Intelligence Guider Local Root CA 的完全信任,重新打开 Safari。
macOS
- 下载并核对
IntelligenceGuider-Root-CA.cer。用 Spotlight 打开「钥匙串访问」,选择「登录」钥匙串,将 .cer 文件拖入窗口。 - 在证书列表双击 Intelligence Guider Local Root CA,展开「信任」,将「安全套接字层(SSL)」设为「始终信任」,关闭窗口并按系统提示确认。
- 重开浏览器,访问 工作站首页。
Windows
- 下载并核对
IntelligenceGuider-Root-CA.cer。按 Win + R,输入certmgr.msc,打开当前用户的证书管理器。 - 展开「受信任的根证书颁发机构」,右键「证书」,选「所有任务 → 导入」,选择下载的 .cer。确认目标存储为「受信任的根证书颁发机构」,完成向导。
- 重开浏览器,访问 工作站首页。如果设备由组织管理或导入被阻止,请交由 IT 配置。
命令行可用 --cacert 指定 PEM 格式的 root.crt。
2. 申请和使用 Key
先在 账号页 注册并登录,再到 申请页 提交设备名和用途。批准后登录同一账号领取 Key。AI 工作台 自动使用账号关联的授权,外部程序通过 Bearer 请求头使用 Key。
3. 调用示例
将 BASE 改为当前网页的协议、地址和端口,CERT 指向管理员提供的证书。将 Key 配置到本机环境变量 IG_API_KEY。
curl --cacert "$CERT" -H "Authorization: Bearer $IG_API_KEY" "$BASE/v1/models"
curl --cacert "$CERT" -H "Authorization: Bearer $IG_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"input":"请回复 OK","stream":false}' "$BASE/v1/responses"
curl --cacert "$CERT" -H "Authorization: Bearer $IG_API_KEY" \
-F action=ocr -F file=@order.png "$BASE/v1/jobs"
异步请求返回任务 ID 和状态地址。用原 Key 查询 GET /v1/jobs/<ID>,完成后按 files[].url 下载。GET /v1/usage 查看用量。遇到 401 请检查 Key;503 可稍后重试。