一句话简介：科大讯飞推出的认知大模型产品，提供网页、App 与开放平台 API 三种使用方式。

主流功能：语音交互、教育、车载、智能硬件

可用性：国内可直接使用（官网、App、讯飞开放平台均为国内服务，无需特殊网络；Spark Lite 版免费）。

适用人群：普通用户：日常问答、写材料、学英语、语音转写，用网页或 App

前置条件：

• 网页/App：手机号注册登录，免费使用基础版
• API 接入：讯飞开放平台账号并实名认证
• Python 调用：Python 3.8+，pip install requests websocket-client（WebSocket 版）或 pip install openai（HTTP 兼容版，以控制台文档为准）
• 说明：星火版本迭代较快（Spark X1.5/X2.5 等），各版本请求地址与 domain 参数以控制台最新文档为准

---

教程一：讯飞星火网页版 / App 使用教程

步骤 1：网页版

1. 浏览器访问 https://xinghuo.xfyun.cn，点击登录/注册，用手机号完成注册登录。
2. 在对话框输入问题即可使用；页面可切换不同模型版本与智能体/插件（以实际页面为准）。

步骤 2：手机 App

1. 在应用商店搜索「讯飞星火」，认准科大讯飞出品，下载安装。
2. 用同一手机号登录，可语音输入，适合开车、走路等场景。

步骤 3：高效使用小技巧

• 办公场景善用「智能体/模板」：写周报、会议纪要、公文都有现成模板。
• 语音强项：录音转文字、方言识别、中英翻译是星火的传统优势，可直接在 App 里试。
• 重要事实请交叉核对，大模型可能产生幻觉。

---

教程二：讯飞开放平台 API 接入教程

步骤 1：注册并实名

1. 访问讯飞开放平台 https://www.xfyun.cn，注册账号并完成实名认证。

步骤 2：创建应用，获取三件套

1. 登录后进入「控制台」，找到「星火大模型」/「语音/认知大模型」相关服务。
2. 点击「创建应用」，填写应用名称、选择应用类型，提交。
3. 在应用详情页拿到三个关键参数：APPID、APIKey、APISecret（注意区分大小写，复制时不要多带空格）。

步骤 3：查看 API 文档，确认版本与地址

1. 访问星火 API 页面 https://xinghuo.xfyun.cn/sparkapi，点击「产品定价/立即调用」进入文档。
2. 确认你要用的版本对应的请求地址与 domain 参数（历史版本示例，以控制台为准）：
   • Spark Lite：wss://spark-api.xf-yun.com/v1.1/chat，domain=lite（免费）
   • Spark Pro：wss://spark-api.xf-yun.com/v3.1/chat，domain=generalv3
   • Spark Max：wss://spark-api.xf-yun.com/v3.5/chat，domain=generalv3.5
   • Spark 4.0 Ultra：wss://spark-api.xf-yun.com/v4.0/chat，domain=4.0Ultra

步骤 4：下载官方调用示例并跑通（WebSocket 版）

1. 在 API 文档「请求说明」部分找到「Python 调用示例」下载链接，下载解压。
2. 用编辑器打开 http_demo.py（或文档中的 WebSocket 示例），把代码里的 appid、api_key、api_secret 换成步骤 2 获取的三件套。
3. 运行脚本，输入"你是谁"，收到模型回复即接入成功。

步骤 5：核心调用逻辑（Python 简化版思路）

官方示例的核心是：用 APIKey+APISecret 按规则生成鉴权 URL → 建立 WebSocket 连接 → 发送 JSON（含 domain、对话 messages）→ 接收流式返回拼接文本。具体签名算法请直接抄官方示例代码，不要自己重写（签名细节易错）。

# 伪代码：整体流程（以官方示例为准）
# 1. 用 api_key/api_secret 生成带签名的 wss 请求地址
# 2. websocket 连接该地址
# 3. 发送 {"header": {"app_id": APPID}, "parameter": {"chat": {"domain": "lite", ...}},
#           "payload": {"message": {"text": [{"role": "user", "content": "你好"}]}}}
# 4. 循环接收返回，拼接 choices[0].text 字段

步骤 6：查看用量

在讯飞开放平台控制台查看各版本剩余量/账单。Spark Lite 为免费版，适合个人项目与调试。

---

常见问题

1. APPID、APIKey、APISecret 在哪看？ 讯飞开放平台 → 控制台 → 我的应用 → 点击应用名称 → 应用详情页。注意 APIKey 与 APISecret 是两串不同的字符串，别填反。

2. 返回鉴权错误（如 10013/11200 类错误）？ 多为密钥复制问题：检查是否多带空格、是否选对了应用、domain 与请求地址是否匹配所选版本。

3. WebSocket 和 HTTP 接口用哪个？ 早期版本以 WebSocket 为主；控制台若提供 HTTP 兼容接口（Bearer Token 方式），新项目建议优先用 HTTP，心智负担更低。具体以当前文档为准。

4. Spark X2.5 怎么接入？ 截至 2026-10-05 未验证到 X2.5 的具体请求地址与参数，请以讯飞开放平台控制台最新文档为准；接入流程（创建应用→拿三件套→按文档调用）不变。

5. 免费额度用完了怎么办？ Spark Lite 版免费；其他版本按量计费，可在控制台购买资源包。个人学习/小项目建议先用 Lite 版跑通全流程。

---

---