配置 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 的使用限制