Kapinote logo文档
AI 功能

云端 AI 服务

查阅各主流云端大模型服务商(OpenAI、Anthropic、Gemini、DeepSeek、阿里云百炼等)所需的接入凭据、网关地址与模型标识。

Kapinote 支持直接接入全球顶尖的商用大模型 API 以及各类 OpenAI-compatible 兼容网关。在服务商后台生成 API Key 后,进入 设置 → AI → 云端 完成配置,保留默认 Base URL 并填写对应模型标识,点击 验证 连通即可。

模型标识提示: AI 模型的演进极其迅速,各服务商推出的新模型版本通常早于客户端发版周期。应用内预置的模型选项仅供参考,请以各服务商官方开发者文档中公布的最新的准确 Model ID 为准。

支持的服务商与默认配置速查

服务商Kapinote 预置默认地址(Base URL)凭据获取与配置指引
OpenAI APIhttps://api.openai.com参考 OpenAI 快速开始 创建 API Key
Azure OpenAI你的 Azure 资源部署地址Model 字段填写 Azure 部署名称;填入 API Key 与 Endpoint
OpenAI 兼容服务你的聚合网关或中转地址填入该服务商提供的 API Key、网关地址与准确 Model ID
Anthropichttps://api.anthropic.comAnthropic Console 生成 API Key
Google Geminihttps://generativelanguage.googleapis.com/v1beta参考 Gemini API 入门指引 获取 API Key
OpenRouterhttps://openrouter.ai/apiOpenRouter 设置 中创建 Key,模型填写 provider/model(如 anthropic/claude-3.7-sonnet
DeepSeekhttps://api.deepseek.com/v1在 DeepSeek 开放平台创建 Key,模型填 deepseek-chatdeepseek-reasoner,详见 DeepSeek 文档
Moonshot (Kimi)https://api.moonshot.cn/v1Moonshot 开放平台 创建 API Key
阿里云百炼 (DashScope)https://dashscope.aliyuncs.com/compatible-mode/v1按照 阿里云百炼 API Key 文档 创建 Key,填入通义千问模型(如 qwen-plusqwen-max
智谱 AI (Z.AI)https://api.z.ai/api/paas/v4/chat/completions在智谱开放平台创建 Key,参考 Z.AI 文档 选择 GLM 模型
AWS Bedrockus-east-1(填写 AWS Region)创建 Bedrock API 凭据,并在控制台开通 模型访问权限(Model Access)

OpenAI 的三种连接形态

  • OpenAI 官方 API: 采用标准的官方 API Key 与 Model ID(如 gpt-4ogpt-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-1us-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 存在泄露风险,请立即在对应服务商控制台注销废弃并重新生成。