配置讯飞星火

讯飞星火（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)
• 定价说明