配置訊飛星火

訊飛星火（Spark）是科大訊飛推出的認知大模型，具備跨領域知識和語言理解能力。支援多輪對話、程式碼生成、邏輯推理等功能，特別擅長中文語義理解和專業領域應用。

1. 獲取訊飛星火 API Key

1.1 訪問訊飛開放平臺

訪問科大訊飛開放平臺並登入：https://console.xfyun.cn/

1.2 進入控制檯

登入後，點選右上角的 控制檯。

1.3 建立應用

1. 點選左側選單的 我的應用
2. 點選 建立應用
3. 填寫應用名稱（例如：CueMate）
4. 選擇應用型別
5. 點選 確定

1.4 獲取 APIPassword

1. 在應用列表中，找到剛才建立的應用
2. 點選 檢視
3. 找到並複製 APIPassword（用於 OpenAI 相容介面）

重要：APIPassword 用於 OpenAI 相容的 HTTP 介面認證。

1.5 領取免費 tokens

重要步驟：首次使用需要領取免費 tokens，否則會提示 AppIdNoAuthError 錯誤。

1. 在應用詳情頁面，找到 立即購買 按鈕
2. 選擇免費套餐（個人認證可領取 20 萬 tokens）
3. 點選領取，完成 tokens 申領

訊飛星火提供免費 tokens 額度：

• 個人認證：20 萬 tokens（免費）
• 企業認證：100 萬 tokens（免費）
• 付費套餐：根據需求購買

2. 在 CueMate 中配置訊飛星火模型

2.1 進入模型設定頁面

登入 CueMate 系統後，點選右上角下拉選單的 模型設定。

2.2 新增新模型

點選右上角的 新增模型 按鈕。

2.3 選擇訊飛星火服務商

在彈出的對話方塊中：

1. 服務商型別：選擇 訊飛星火
2. 點選後 自動進入下一步

2.4 填寫配置資訊

在配置頁面填寫以下資訊：

基礎配置

1. 模型名稱：為這個模型配置起個名字（例如：星火 4.0 Ultra）
2. API URL：保持預設 https://spark-api-open.xf-yun.com/v1（OpenAI 相容格式）
3. API Key：貼上剛才複製的 APIPassword
4. 模型版本：選擇要使用的模型 ID，常用模型包括：
   • 4.0Ultra：星火 4.0 Ultra，最大輸出 32K，最強效能，支援 Function Call
   • max-32k：星火 Max-32K，最大輸出 32K，超長上下文
   • generalv3.5：星火 Max，最大輸出 8K，高效能通用模型
   • pro-128k：星火 Pro-128K，最大輸出 128K，超長上下文
   • generalv3：星火 Pro，最大輸出 8K，價效比高
   • lite：星火 Lite，最大輸出 4K，免費版本

高階配置（可選）

展開 高階配置 面板，可以調整以下引數：

CueMate 介面可調引數：

1. 溫度（temperature）：控制輸出隨機性

   • 範圍：0-1
   • 推薦值：0.5
   • 作用：值越高輸出越隨機創新，值越低輸出越穩定保守
   • 使用建議：
     • 創意寫作/頭腦風暴：0.7-0.9
     • 常規對話/問答：0.5-0.7
     • 程式碼生成/精確任務：0.2-0.4
   • 注意：訊飛星火的 temperature 範圍是 0-1，與 OpenAI 的 0-2 不同

2. 輸出最大 tokens（max_tokens）：限制單次輸出長度

   • 範圍：256 - 131072（根據模型而定）
   • 推薦值：8192
   • 作用：控制模型單次響應的最大字數
   • 模型限制：
     • pro-128k：最大 128K tokens
     • X1-Preview：最大 64K tokens
     • 4.0Ultra/max-32k/X1：最大 32K tokens
     • generalv3.5/generalv3：最大 8K tokens
     • lite：最大 4K tokens
   • 使用建議：
     • 簡短問答：1024-2048
     • 常規對話：4096-8192
     • 長文生成：16384-32768
     • 超長文件：65536-131072（僅 pro-128k）

訊飛星火 API 支援的其他高階引數：

雖然 CueMate 介面只提供 temperature 和 max_tokens 調整，但如果你透過 API 直接呼叫訊飛星火，還可以使用以下高階引數（訊飛星火採用 OpenAI 相容的 API 格式）：

3. top_k

   • 範圍：1-6
   • 預設值：4
   • 作用：從機率最高的 k 個候選詞中取樣
   • 使用建議：
     • 更多樣化：5-6
     • 更保守：1-3
   • 注意：訊飛星火的 top_k 最大值為 6

4. frequency_penalty（頻率懲罰）

   • 範圍：1.0-2.0
   • 預設值：1.0
   • 作用：降低重複相同詞彙的機率
   • 使用建議：
     • 減少重複：1.2-1.5
     • 正常輸出：1.0（預設）
   • 注意：訊飛的範圍與 OpenAI 不同（1-2 vs -2 to 2）

5. chat_id

   • 型別：字串
   • 作用：用於上下文關聯的會話 ID
   • 使用場景：多輪對話時傳入相同 chat_id 保持上下文

6. stream（流式輸出）

   • 型別：布林值
   • 預設值：false
   • 作用：啟用 SSE 流式返回，邊生成邊返回
   • CueMate 中：自動處理，無需手動設定

7. tools（工具呼叫）

   • 型別：物件陣列
   • 作用：定義模型可以呼叫的工具/函式
   • 使用場景：Function Calling（僅 4.0Ultra 和 X1-Preview 支援）
   • 示例：

     {
       "tools": [
         {
           "type": "function",
           "function": {
             "name": "get_current_weather",
             "description": "獲取指定位置的當前天氣",
             "parameters": {
               "type": "object",
               "properties": {
                 "location": {
                   "type": "string",
                   "description": "城市名稱"
                 }
               }
             }
           }
         }
       ]
     }

訊飛星火特色引數：

8. uid
   • 型別：字串
   • 作用：使用者唯一標識，用於追蹤和個性化
   • 使用建議：傳入使用者 ID 以便追蹤使用情況

場景	temperature	max_tokens	top_k	frequency_penalty	chat_id
創意寫作	0.7-0.9	4096-8192	5-6	1.3	null
程式碼生成	0.2-0.4	2048-4096	3-4	1.0	null
問答系統	0.5-0.7	1024-2048	4	1.0	session_id
摘要總結	0.3-0.5	512-1024	3	1.0	null
多輪對話	0.5	2048	4	1.0	conversation_id

2.5 測試連線

填寫完配置後，點選 測試連線 按鈕，驗證配置是否正確。

如果配置正確，會顯示測試成功的提示，並返回模型的響應示例。

如果配置錯誤，會顯示測試錯誤的日誌，並且可以透過日誌管理，檢視具體報錯資訊。

2.6 儲存配置

測試成功後，點選 儲存 按鈕，完成模型配置。

3. 使用模型

透過右上角下拉選單，進入系統設定介面，在大模型服務商欄目選擇想要使用的模型配置。

配置完成後，可以在面試訓練、問題生成等功能中選擇使用此模型，當然也可以在面試的選項中單獨選擇此次面試的模型配置。

4. 支援的模型列表

4.1 X1 系列（推理模型，需使用 /v2 API）

序號	模型名稱	模型 ID	最大輸出	上下文	適用場景
1	星火 X1	x1	32K tokens	32K	深度推理、複雜邏輯、數學問題
2	星火 X1-Preview	X1-Preview	64K tokens	64K	推理增強、Function Call、長文字

注意：X1 系列模型需要將 API URL 改為 https://spark-api-open.xf-yun.com/v2

4.2 通用系列（使用 /v1 API）

序號	模型名稱	模型 ID	最大輸出	上下文	適用場景
1	星火 4.0 Ultra	4.0Ultra	32K tokens	32K	最強效能、複雜推理、Function Call
2	星火 Max-32K	max-32k	32K tokens	32K	超長上下文、大文件處理
3	星火 Max	generalv3.5	8K tokens	8K	高效能通用、技術面試
4	星火 Pro-128K	pro-128k	128K tokens	128K	超長上下文、文件分析
5	星火 Pro	generalv3	8K tokens	8K	通用場景、價效比高
6	星火 Lite	lite	4K tokens	8K	免費版本、快速響應

5. 常見問題

5.1 APIPassword 無效

現象：測試連線時提示 API Key 錯誤

解決方案：

1. 檢查 APIPassword 是否完整複製
2. 確認應用已建立並處於啟用狀態
3. 驗證 APIPassword 未過期
4. 注意：使用 OpenAI 相容介面需要 APIPassword，不是 APPID/APIKey

5.2 請求超時

現象：測試連線或使用時長時間無響應

解決方案：

1. 檢查網路連線是否正常
2. 確認 API URL 配置正確：https://spark-api-open.xf-yun.com/v1
3. 檢查防火牆設定

5.3 配額不足或 AppIdNoAuthError 錯誤

現象：測試連線時提示 AppIdNoAuthError (錯誤碼11200) 或配額已用完

解決方案：

1. 首次使用必須領取免費 tokens（參見步驟 1.5）
2. 登入訊飛開放平臺檢視賬戶餘額和 tokens 配額
3. 在應用詳情頁點選"立即購買"領取免費套餐：
   • 個人認證：20 萬 tokens（免費）
   • 企業認證：100 萬 tokens（免費）
4. 如需更多配額，可購買付費套餐
5. Lite 版本為免費版本，可優先測試

5.4 服務呼叫失敗

現象：提示服務不可用

解決方案：

1. 確認已開通對應的模型服務
2. 檢查應用許可權配置
3. 確認服務狀態正常
4. 部分高階功能（Function Call、聯網搜尋）僅 4.0 Ultra 和 Max 支援

相關連結

• 訊飛星火官網
• 訊飛開放平臺
• [HTTP 呼叫文件](https://www.xfyun.cn/doc/spark/HTTP 呼叫文件.html)
• 定價說明