配置 OpenAI
OpenAI 是全球领先的人工智能研究公司，提供 GPT-5、GPT-4.1、GPT-4o 等先进的大语言模型服务。通过 OpenAI API，开发者可以访问最前沿的 AI 能力，支持复杂推理、多模态理解、代码生成等多种应用场景。
1. 获取 OpenAI API Key
1.1 访问 AI 平台
访问 AI 官网并登录：https://platform.openai.com/
1.2 进入 API Keys 页面
点击左侧菜单的 API keys，进入密钥管理页面。
1.3 创建新的 API Key
点击右上角的 Create new secret key 按钮。
1.4 设置 API Key 名称
在弹出的对话框中：
- 输入 API Key 的名称（例如：CueMate）
- 点击 Create secret key 按钮
1.5 复制 API Key
创建成功后，系统会显示 API Key。
WARNING
重要提示：
- 这是唯一一次可以看到完整 API Key 的机会
- 请立即复制并妥善保存
- 不要将 API Key 分享给他人或提交到代码仓库
- 如果泄露，请立即在 OpenAI 平台撤销该 Key
点击复制按钮，API Key 已复制到剪贴板。
2. 在 CueMate 中配置 OpenAI 模型
2.1 进入模型设置页面
登录 CueMate 系统后，点击右上角下拉菜单的 模型设置。
2.2 添加新模型
点击右上角的 添加模型 按钮。
2.3 选择 OpenAI 服务商
在弹出的对话框中：
- 服务商类型：选择 OpenAI
- 点击后 自动进入下一步
2.4 填写配置信息
在配置页面填写以下信息：
基础配置
- 模型名称：为这个模型配置起个名字（例如：GPT-4 生产环境）
- API Key：粘贴刚才复制的 OpenAI API Key
- Base URL：保持默认
https://api.openai.com/v1（如果使用代理，填写代理地址） - 模型版本：选择要使用的模型
gpt-5：最新旗舰模型，最强推理能力gpt-5-mini：轻量级 GPT-5，速度快gpt-4.1：GPT-4 升级版，性能提升gpt-4o：多模态模型，支持图像理解gpt-4o-mini：轻量级多模态，性价比高gpt-4-turbo：高性能版本gpt-3.5-turbo：经济实惠，快速响应
高级配置（可选）
展开 高级配置 面板，可以调整以下参数：
CueMate 界面可调参数：
温度（temperature）：控制输出随机性
- 范围：0-2
- 推荐值：0.7
- 作用：值越高输出越随机创新，值越低输出越稳定保守
- 使用建议：
- 创意写作/头脑风暴：1.0-1.5
- 常规对话/问答：0.7-0.9
- 代码生成/精确任务：0.3-0.5
输出最大 tokens（max_tokens）：限制单次输出长度
- 范围：256 - 16384（根据模型而定）
- 推荐值：8192
- 作用：控制模型单次响应的最大字数
- 模型限制：
- GPT-5 系列、GPT-4.1、GPT-4o 系列：最大 16K tokens
- GPT-4：最大 8K tokens
- GPT-4 Turbo、GPT-3.5 Turbo：最大 4K tokens
- 使用建议：
- 简短问答：1024-2048
- 常规对话：4096-8192
- 长文生成：16384（仅支持的模型）
OpenAI API 支持的其他高级参数：
虽然 CueMate 界面只提供 temperature 和 max_tokens 调整，但如果你通过 API 直接调用 OpenAI，还可以使用以下高级参数：
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（默认）
- 强制多样化：1.0-2.0
presence_penalty（存在惩罚）
- 范围：-2.0 到 2.0
- 默认值：0
- 作用：降低已出现过的词汇再次出现的概率（基于是否出现）
- 使用建议：
- 鼓励新话题：0.3-0.8
- 允许重复话题：0（默认）
stop（停止序列）
- 类型：字符串或数组（最多 4 个字符串）
- 默认值：null
- 作用：当生成内容包含指定字符串时停止
- 示例：
["###", "用户:", "\n\n"] - 使用场景：
- 结构化输出：使用分隔符控制格式
- 对话系统：防止模型代替用户说话
logit_bias（词元偏置）
- 类型：字典，映射 token ID 到偏置值
- 范围：-100 到 100
- 作用：调整特定 token 的出现概率
- 使用场景：
- 禁止特定词汇：设置为 -100
- 鼓励特定词汇：设置为正值
stream（流式输出）
- 类型：布尔值
- 默认值：false
- 作用：启用 SSE 流式返回，边生成边返回
- CueMate 中：自动处理，无需手动设置
seed（随机种子）
- 类型：整数
- 默认值：null
- 作用：固定随机种子，相同输入产生相同输出
- 使用场景：
- 可复现的测试
- 对比实验
- 注意：尽力而为，不保证完全一致
n（生成数量）
- 类型：整数
- 默认值：1
- 范围：1-10
- 作用：一次请求生成多个候选回复
- 注意：会按生成数量计费
user（用户标识）
- 类型：字符串
- 作用：标识最终用户，帮助 OpenAI 监测滥用
- 建议：生产环境建议设置
参数组合建议：
| 场景 | temperature | max_tokens | top_p | frequency_penalty | presence_penalty |
|---|---|---|---|---|---|
| 创意写作 | 1.0-1.2 | 4096-8192 | 0.95 | 0.5 | 0.5 |
| 代码生成 | 0.2-0.5 | 2048-4096 | 0.9 | 0.0 | 0.0 |
| 问答系统 | 0.7 | 1024-2048 | 0.9 | 0.0 | 0.0 |
| 摘要总结 | 0.3-0.5 | 512-1024 | 0.9 | 0.0 | 0.0 |
| 头脑风暴 | 1.2-1.5 | 2048-4096 | 0.95 | 0.8 | 0.8 |
2.5 测试连接
填写完配置后，点击 测试连接 按钮，验证配置是否正确。
如果配置正确，会显示测试成功的提示，并返回模型的响应示例。
如果配置错误，会显示测试错误的日志，并且可以通过日志管理，查看具体报错信息。
2.6 保存配置
测试成功后，点击 保存 按钮，完成模型配置。
3. 使用模型
通过右上角下拉菜单，进入系统设置界面，在大模型供应商栏目选择想要使用的模型配置。
配置完成后，可以在面试训练、问题生成等功能中选择使用此模型， 当然也可以在面试的选项中单此选择此次面试的模型配置。
4. 支持的模型列表
| 序号 | 模型名称 | 模型 ID | 最大输出 | 适用场景 |
|---|---|---|---|---|
| 1 | GPT-5 | gpt-5 | 16K tokens | 最新旗舰模型，最强推理能力 |
| 2 | GPT-5 Mini | gpt-5-mini | 16K tokens | 轻量级GPT-5，速度快 |
| 3 | GPT-5 Nano | gpt-5-nano | 16K tokens | 超轻量级，低成本 |
| 4 | GPT-4.1 | gpt-4.1 | 16K tokens | GPT-4 升级版，性能提升 |
| 5 | GPT-4o | gpt-4o | 16K tokens | 多模态模型，支持图像理解 |
| 6 | GPT-4o Mini | gpt-4o-mini | 16K tokens | 轻量级多模态模型 |
| 7 | GPT-4 Turbo | gpt-4-turbo | 4K tokens | 高性能版本 |
| 8 | GPT-4 | gpt-4 | 8K tokens | 经典旗舰模型 |
| 9 | GPT-3.5 Turbo | gpt-3.5-turbo | 4K tokens | 经济实惠，快速响应 |
5. 常见问题
5.1 API Key 无效
现象：测试连接时提示 "Invalid API Key" 或 "Incorrect API key provided"
解决方案：
- 检查 API Key 是否完整复制（注意没有多余空格）
- 确认 API Key 未被撤销
- 检查 OpenAI 账户是否有可用额度
5.2 请求超时
现象：测试连接或使用时长时间无响应
解决方案：
- 检查网络连接是否正常
- 如果在国内，尝试使用代理或第三方 API 中转服务
- 检查防火墙设置
5.3 配额不足
现象：提示 "You exceeded your current quota" 或 "Rate limit exceeded"
解决方案：
- 登录 OpenAI 平台查看账户余额
- 充值或升级账户套餐
- 检查 API Key 的使用限制