配置 AI API Key
AgileShot 的 AI 智能标注功能(OCR / 翻译 / 解释 / 敏感模糊)需要你自己的 AI API Key。
隐私承诺
- API Key 本地加密存储(QtKeychain,跨平台凭据管理器)
- 截图数据仅在你点击 AI 功能时发送给你配置的服务商
- AgileShot 不会收集 / 转发 / 上传任何截图或 Key
- 数据流: 你的电脑 → 你的 API Key → 你选的服务商 → 直接返回
支持的 AI 服务商
| 服务商 | 模型推荐 | 支持能力 | 申请地址 |
|---|---|---|---|
| Anthropic | claude-3-5-sonnet-20241022 / claude-opus-4-7 | OCR / 翻译 / 解释 / 敏感检测 | console.anthropic.com |
| OpenAI | gpt-4o / gpt-4o-mini | 同上 | platform.openai.com |
| 任意 OpenAI 兼容端点 | 取决于服务商 | 取决于模型能力 | 自填 base_url |
模型必须支持 Vision (多模态)
AgileShot 的截图分析依赖视觉理解。请确保选的模型支持图片输入,否则 OCR / 翻译会失败。
- ✅
claude-3-5-sonnet/claude-opus-4-7全系列 - ✅
gpt-4o/gpt-4-vision-preview/gpt-4o-mini - ❌
gpt-3.5-turbo/claude-instant(不支持图片)
配置步骤
1. 打开设置
托盘右键 → 设置 → 切换到 AI 选项卡。
也可以从主窗口菜单栏 → 设置 → AI,或快捷键 Ctrl+,。
2. 选择服务商
┌──────────────────────────────────────────┐
│ 服务商 │ ⦿ Anthropic ○ OpenAI ○ 自定义 │
│ │
│ Base URL https://api.anthropic.com │
│ API Key sk-ant-xxxxxxxxxxxxxxxxxxxx │
│ 模型 claude-3-5-sonnet-20241022 ▼ │
│ │
│ [ 测试连接 ] [ 保存 ] │
└──────────────────────────────────────────┘填好后点 测试连接,会发送一个简单 ping 请求验证 Key 有效。成功后点 保存。
3. 走代理(可选)
如果你身处需要代理才能访问 Anthropic / OpenAI 的地区:
- 配置系统代理(Settings → Proxy)
- 或者用国内的 OpenAI 兼容服务商(自填 Base URL,如
https://api.deepseek.com/v1)
4. 验证
切回主界面 → 按 F6 截图 → 选区 → 工具栏右侧 ✨ AI → 选 "OCR" → 应该看到识别结果浮泡。
常见错误
| 错误信息 | 原因 / 解决 |
|---|---|
401 Unauthorized | API Key 无效或已过期。重新生成 Key |
429 Too Many Requests | 触发限流。降低调用频率或升级套餐 |
503 Service Unavailable | 服务商临时不可用。稍后重试 |
连接超时 | 网络不通或需要代理。检查防火墙 / 代理设置 |
模型不支持图片 | 切换到 Vision 模型(见上表) |
余额不足 | 充值或绑定信用卡 |
关于 Token 消耗
AI 调用按 token 计费(图片折算 token,视模型而异)。粗略参考:
| 操作 | 输入 token(图片) | 输出 token | 单次估算成本 (Claude 3.5 Sonnet) |
|---|---|---|---|
| OCR (一屏文字) | ~1000-2000 | ~200-500 | ~$0.005 |
| 翻译 | ~1000-2000 | ~500-1000 | ~$0.01 |
| 解释代码 / 报错 | ~1000-2000 | ~500-1500 | ~$0.015 |
| 敏感信息检测 | ~1000-2000 | ~100-300 | ~$0.003 |
节省成本的几个习惯
- 用
claude-3-5-haiku/gpt-4o-mini替代旗舰模型(便宜 10 倍,OCR 完全够) - 不需要 AI 时就别点 ✨ 按钮(无消耗)
- 截大屏前先剪小再喂(图片越小 token 越少)