配置 Kimi
Kimi 是月之暗面（Moonshot AI）开发的大语言模型服务，以超长上下文（200万字）处理能力著称。支持长文档阅读、文件分析、联网搜索等功能，特别适合处理大量文本信息的场景。
1. 获取 Kimi API Key
1.1 访问 Kimi 开放平台
访问月之暗面开放平台并登录：https://platform.moonshot.cn/
1.2 进入 API 密钥管理页面
登录后，点击左侧菜单的 API 密钥管理。
1.3 创建新的 API Key
点击右上角的 新建 按钮。
1.4 设置 API Key 信息
在弹出的对话框中：
- 输入密钥名称（例如：CueMate）
- 点击 确定 按钮
1.5 复制 API Key
创建成功后，系统会显示 API Key。
重要：请立即复制并妥善保存，API Key 以 sk- 开头。
点击复制按钮，API Key 已复制到剪贴板。
2. 在 CueMate 中配置 Kimi 模型
2.1 进入模型设置页面
登录 CueMate 系统后，点击右上角下拉菜单的 模型设置。
2.2 添加新模型
点击右上角的 添加模型 按钮。
2.3 选择 Kimi 服务商
在弹出的对话框中：
- 服务商类型：选择 Kimi
- 点击后 自动进入下一步
2.4 填写配置信息
在配置页面填写以下信息：
基础配置
- 模型名称：为这个模型配置起个名字（例如：Kimi-128K）
- API URL：保持默认
https://api.moonshot.cn/v1（OpenAI 兼容格式） - API Key：粘贴刚才复制的 Kimi API Key
- 模型版本：选择要使用的模型ID，常用模型包括：
moonshot-v1-128k：128K 超长上下文，最大输出65K，适合超长文档理解、多轮对话moonshot-v1-32k：32K 长上下文，最大输出16K，适合长文档处理、复杂推理moonshot-v1-8k：8K 标准上下文，最大输出4K，适合常规对话、快速响应
高级配置（可选）
展开 高级配置 面板，可以调整以下参数：
CueMate 界面可调参数：
温度（temperature）：控制输出随机性
- 范围：0-1（注意：Kimi 的温度上限是 1，不同于 OpenAI 的 2）
- 推荐值：0.3
- 作用：值越高输出越随机创新，值越低输出越稳定保守
- 使用建议：
- 创意写作/头脑风暴：0.7-0.9
- 常规对话/问答：0.3-0.5
- 代码生成/精确任务：0.1-0.3
- 长文档分析：0.2-0.4
输出最大 tokens（max_tokens）：限制单次输出长度
- 范围：256 - 65536（根据模型而定）
- 推荐值：8192
- 作用：控制模型单次响应的最大字数
- 模型限制：
- moonshot-v1-128k：最大 65K tokens
- moonshot-v1-32k：最大 16K tokens
- moonshot-v1-8k：最大 4K tokens
- 使用建议：
- 简短问答：1024-2048
- 常规对话：4096-8192
- 长文生成：16384-32768
- 超长文档：65536（仅 128k 模型）
Kimi API 支持的其他高级参数：
虽然 CueMate 界面只提供 temperature 和 max_tokens 调整，但如果你通过 API 直接调用 Kimi，还可以使用以下高级参数（Kimi 采用 OpenAI 兼容的 API 格式）：
top_p（nucleus sampling）
- 范围：0-1
- 默认值：1
- 作用：从概率累积达到 p 的最小候选集中采样
- 与 temperature 的关系：通常只调整其中一个
- 使用建议：
- 保持多样性但避免离谱：0.9-0.95
- 更保守的输出：0.7-0.8
frequency_penalty（频率惩罚）
- 范围：-2.0 到 2.0
- 默认值：0
- 作用：降低重复相同词汇的概率（基于词频）
- 使用建议：
- 减少重复：0.3-0.8
- 允许重复：0（默认）
presence_penalty（存在惩罚）
- 范围：-2.0 到 2.0
- 默认值：0
- 作用：降低已出现过的词汇再次出现的概率（基于是否出现）
- 使用建议：
- 鼓励新话题：0.3-0.8
- 允许重复话题：0（默认）
stop（停止序列）
- 类型：字符串或数组
- 默认值：null
- 作用：当生成内容包含指定字符串时停止
- 示例：
["###", "用户:", "\n\n"]
stream（流式输出）
- 类型：布尔值
- 默认值：false
- 作用：启用 SSE 流式返回
- CueMate 中：自动处理，无需手动设置
参数组合建议：
| 序号 | 场景 | temperature | max_tokens | top_p | frequency_penalty | presence_penalty |
|---|---|---|---|---|---|---|
| 1 | 创意写作 | 0.7-0.9 | 8192-16384 | 0.95 | 0.5 | 0.5 |
| 2 | 代码生成 | 0.1-0.3 | 2048-4096 | 0.9 | 0.0 | 0.0 |
| 3 | 问答系统 | 0.3-0.5 | 1024-2048 | 0.9 | 0.0 | 0.0 |
| 4 | 文档分析 | 0.2-0.4 | 8192-32768 | 0.9 | 0.0 | 0.0 |
| 5 | 超长文档 | 0.3 | 32768-65536 | 0.9 | 0.0 | 0.0 |
2.5 测试连接
填写完配置后，点击 测试连接 按钮，验证配置是否正确。
如果配置正确，会显示测试成功的提示，并返回模型的响应示例。
如果配置错误，会显示测试错误的日志，并且可以通过日志管理，查看具体报错信息。
2.6 保存配置
测试成功后，点击 保存 按钮，完成模型配置。
3. 使用模型
通过右上角下拉菜单，进入系统设置界面，在大模型供应商栏目选择想要使用的模型配置。
配置完成后，可以在面试训练、问题生成等功能中选择使用此模型， 当然也可以在面试的选项中单此选择此次面试的模型配置。
4. 支持的模型列表
4.1 Moonshot v1 系列
| 序号 | 模型名称 | 模型 ID | 上下文长度 | 最大输出 | 适用场景 |
|---|---|---|---|---|---|
| 1 | Moonshot v1 128K | moonshot-v1-128k | 128K tokens | 65K tokens | 超长文档理解、多轮对话 |
| 2 | Moonshot v1 32K | moonshot-v1-32k | 32K tokens | 16K tokens | 长文档处理、复杂推理 |
| 3 | Moonshot v1 8K | moonshot-v1-8k | 8K tokens | 4K tokens | 常规对话、快速响应 |
5. 常见问题
5.1 API Key 无效
现象：测试连接时提示 API Key 错误
解决方案：
- 检查 API Key 是否以
sk-开头 - 确认 API Key 完整复制
- 检查账户是否有可用额度
5.2 请求超时
现象：测试连接或使用时长时间无响应
解决方案：
- 检查网络连接是否正常
- 确认 API URL 地址正确
- 检查防火墙设置
5.3 配额不足
现象：提示配额已用完或余额不足
解决方案：
- 登录月之暗面平台查看账户余额
- 充值或申请更多配额
- 选择合适的模型版本