AI 功能
云端 AI 服务
查阅各主流云端大模型服务商(OpenAI、Anthropic、Gemini、DeepSeek、阿里云百炼等)所需的接入凭据、网关地址与模型标识。
Kapinote 支持直接接入全球顶尖的商用大模型 API 以及各类 OpenAI-compatible 兼容网关。在服务商后台生成 API Key 后,进入 设置 → AI → 云端 完成配置,保留默认 Base URL 并填写对应模型标识,点击 验证 连通即可。
模型标识提示: AI 模型的演进极其迅速,各服务商推出的新模型版本通常早于客户端发版周期。应用内预置的模型选项仅供参考,请以各服务商官方开发者文档中公布的最新的准确 Model ID 为准。
支持的服务商与默认配置速查
| 服务商 | Kapinote 预置默认地址(Base URL) | 凭据获取与配置指引 |
|---|---|---|
| OpenAI API | https://api.openai.com | 参考 OpenAI 快速开始 创建 API Key |
| Azure OpenAI | 你的 Azure 资源部署地址 | Model 字段填写 Azure 部署名称;填入 API Key 与 Endpoint |
| OpenAI 兼容服务 | 你的聚合网关或中转地址 | 填入该服务商提供的 API Key、网关地址与准确 Model ID |
| Anthropic | https://api.anthropic.com | 在 Anthropic Console 生成 API Key |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta | 参考 Gemini API 入门指引 获取 API Key |
| OpenRouter | https://openrouter.ai/api | 在 OpenRouter 设置 中创建 Key,模型填写 provider/model(如 anthropic/claude-3.7-sonnet) |
| DeepSeek | https://api.deepseek.com/v1 | 在 DeepSeek 开放平台创建 Key,模型填 deepseek-chat 或 deepseek-reasoner,详见 DeepSeek 文档 |
| Moonshot (Kimi) | https://api.moonshot.cn/v1 | 在 Moonshot 开放平台 创建 API Key |
| 阿里云百炼 (DashScope) | https://dashscope.aliyuncs.com/compatible-mode/v1 | 按照 阿里云百炼 API Key 文档 创建 Key,填入通义千问模型(如 qwen-plus、qwen-max) |
| 智谱 AI (Z.AI) | https://api.z.ai/api/paas/v4/chat/completions | 在智谱开放平台创建 Key,参考 Z.AI 文档 选择 GLM 模型 |
| AWS Bedrock | us-east-1(填写 AWS Region) | 创建 Bedrock API 凭据,并在控制台开通 模型访问权限(Model Access) |
OpenAI 的三种连接形态
- OpenAI 官方 API: 采用标准的官方 API Key 与 Model ID(如
gpt-4o、gpt-4o-mini)。 - Azure OpenAI: 需填入专属资源 Endpoint,且 Model 字段必须填写你在 Azure 控制台自定义的 Deployment Name(部署名),而非通用模型名。
- OpenAI-compatible 网关: 适用于 OneAPI、NewAPI、Groq、Together AI 等兼容 OpenAI 协议的转发服务,建议配置后先发送一条简短请求验证上下文兼容性。
区域网关与特殊地址注意事项
- 阿里云国内站 vs 国际站: Kapinote 默认使用的是中国内地 DashScope 网关;若你的账号为阿里云国际站(Alibaba Cloud International),需将地址更改为
https://dashscope-intl.aliyuncs.com/compatible-mode/v1。 - 智谱 AI (Z.AI): Kapinote 的预置地址已经完整包含了
/chat/completions路径,请勿随意截断或重复追加路径。 - AWS Bedrock: Base URL 需填入已开通模型权限的 AWS 区域(如
us-east-1、us-west-2),Model 字段需输入 Bedrock 专有模型 ARN 或完整 ID(如anthropic.claude-3-5-sonnet-20241022-v2:0)。
API Key 凭据安全建议
- 为 Kapinote 创建专用的独立 API Key,便于单独统计调用量与账单。
- 在服务商后台为该 Key 设置预算预警(Spending Limit)或单日调用上限。
- 绝不在公开群聊或问题反馈截图中暴露完整的 API Key。
- 若怀疑 Key 存在泄露风险,请立即在对应服务商控制台注销废弃并重新生成。