← 工作站首页接入帮助

CLIENT GUIDE

API 与证书帮助

申请页、AI 工作台和 API 使用同一个局域网 HTTPS 地址。

1. 建立证书信任

首次访问可能仍有 HTTPS 警告。先通过可信渠道向管理员核对 SHA-256 指纹,再安装下载的证书。如果浏览器阻止下载,可请管理员通过 AirDrop 或其他可信渠道发送证书。

  1. iPhone 使用 IntelligenceGuider-Root-CA.cer,按系统提示安装。
  2. 打开「设置 → 通用 → 关于本机 → 证书信任设置」。
  3. 开启对 Intelligence Guider Local Root CA 的完全信任,重新打开 Safari。

macOS

  1. 下载并核对 IntelligenceGuider-Root-CA.cer。用 Spotlight 打开「钥匙串访问」,选择「登录」钥匙串,将 .cer 文件拖入窗口。
  2. 在证书列表双击 Intelligence Guider Local Root CA,展开「信任」,将「安全套接字层(SSL)」设为「始终信任」,关闭窗口并按系统提示确认。
  3. 重开浏览器,访问 工作站首页。

Apple:导入证书 · Apple:证书信任设置

Windows

  1. 下载并核对 IntelligenceGuider-Root-CA.cer。按 Win + R,输入 certmgr.msc,打开当前用户的证书管理器。
  2. 展开「受信任的根证书颁发机构」,右键「证书」,选「所有任务 → 导入」,选择下载的 .cer。确认目标存储为「受信任的根证书颁发机构」,完成向导。
  3. 重开浏览器,访问 工作站首页。如果设备由组织管理或导入被阻止,请交由 IT 配置。

Microsoft:证书存储和导入

命令行可用 --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 可稍后重试。