讯飞星火api

AI TOOL PROFILE工具资料

科大讯飞开放平台提供的星火认知大模型 WebSocket 接口，六个版本独立计量 tokens。

官网地址 https://www.xfyun.cn/doc/spark/Web.html#_1-1-%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80

聊天对话

访问官网

价格计费含输入和输出，各版本独立计量 tokens

平台API / Web

归类聊天对话

收录2026-07-10

复核2026-07-10

编辑评分 4.2 / 5

讯飞星火api编辑总结

EDITOR REVIEW编辑评测

讯飞星火 API 是讯飞开放平台面向开发者提供的星火认知大模型调用接口，通过 WebSocket 协议接入，当前分为 Lite、Pro、Pro-128K、Max、Max-32K 和 4.0 Ultra 六个版本，另有科技文献大模型。计费覆盖输入与输出内容，1 token 约等于 1.5 个中文汉字或 0.8 个英文单词，各版本独立计量 tokens。Ultra 版本已升级至 X1.5 快思考模式，Max 版本套餐将于 26 年 3 月 10 日下线，后端服务升级为 Ultra，授权用量与 Ultra 合并。短板是接入前需要先在控制台获取 AppID、APIKey、APISecret 三件套，且不同版本对应不同的请求地址和 domain 参数，切换版本时要同步改代码。

讯飞星火api是什么？

讯飞星火 API 由科大讯飞打造，是讯飞开放平台在语音技术之外开放的大模型调用能力。平台本身以「云+端」形式向开发者提供语音合成、语音识别、语音唤醒、语义理解、人脸识别等服务，覆盖 Android、iOS、Java、Windows、Linux 等主流平台，国内外企业、中小创业团队和个人开发者均可接入。星火 API 是其认知大模型能力的接口层。

接口当前有 Lite、Pro、Pro-128K、Max、Max-32K 和 4.0 Ultra 六个通用版本，以及重点优化论文问答与写作的科技文献大模型（kjwx），各版本独立计量 tokens。传输协议为 ws(s)，官方强烈推荐使用 wss。仅 Spark Pro、Spark Max 和 Spark Ultra 支持搜索插件，天气、日期类问题依赖搜索；当前仅 Spark Ultra 和 Max 版本支持返回联网检索的信源标题及地址。

开发者使用前需要到产品页面领取免费额度，再到控制台获取 AppID、APIKey、APISecret，然后按接口文档组装请求。多轮对话需要把历史问答一起传给服务端，并按 system-user-assistant 的顺序拼接；system 角色用于设置对话背景，仅 Max、Ultra 版本支持。语音合成、语音识别等能力则通过平台提供的 SDK 和 WebAPI 接入。

讯飞星火api核心功能

CAPABILITIES工具标签

六版本独立计量

通用大模型 API 提供 Lite、Pro、Pro-128K、Max、Max-32K 和 4.0 Ultra 六个版本，每个版本独立计量 tokens，可按任务难度和上下文长度选择型号。

WebSocket 接入

传输协议为 ws(s)，官方强烈推荐使用 wss 提高安全性。不同版本对应不同请求地址与 domain 参数，例如 Ultra 对应 wss://spark-api.xf-yun.com/v4.0/chat。

多轮对话拼接

开发者每次需将历史问答一起传给服务端，按 system-user-assistant-user-assistant 顺序拼接；如无需上下文可只传最新一条问题，system 角色仅 Max、Ultra 版本支持。

联网搜索插件

通过 tools.type 设为 web_search 调用，仅 Pro、Max、Ultra 系列支持。search_mode 可选 normal 标准或 deep 深度，deep 模式引用全文回答更准确，但会带来额外 token 消耗。

信源返回开关

tools.web_search.show_ref_label 默认关闭，开启后触发联网搜索时先返回搜索结果，再返回模型回复内容。当前仅 Spark Ultra 和 Max 版本支持返回联网检索的信源标题及地址。

上下文长度分档

各版本 content 累计 tokens 上限不同：4.0 Ultra 与 Max-32K 不超过 32768，Pro-128K 不超过 131072，Max、Pro、Lite 不超过 8192。超出需自行裁剪历史信息。

生成参数可调

temperature 取值范围 (0，1]，默认 0.5，数学、推理、代码类任务建议调为 0.6；top_k 取值 [1，6] 默认 4；max_tokens 按版本取值不同，Ultra 默认 32768。

科技文献大模型

行业大模型中的科技文献大模型对应 domain 参数 kjwx，重点优化论文问答、写作等垂直领域，请求地址为 wss://spark-openapi-n.cn-huabei-1.xf-yun.com/v1.1/chat_kjwx。

讯飞星火api值不值得用？

VERDICT工具标签

当你需要一个中文语境下成熟、分档清晰的国产大模型接口，尤其是已经用讯飞语音能力、希望在同一平台完成听、说、读、写能力集成时，星火 API 值得优先考虑：六个版本从 Lite 到 4.0 Ultra 覆盖不同成本和上下文长度需求，Pro 及以上还支持联网搜索。但要注意 Max 版本套餐将于 26 年 3 月 10 日下线，后端升级为 Ultra 并合并授权用量，已有 Max 调用的项目需要提前规划迁移；同时不同版本对应不同的请求地址和 domain 参数，切换版本要同步改代码。如果只做简短问答、不需要联网和长上下文，Lite 或 Pro 的 8192 tokens 上限已经够用。

建议选它的情况

已经使用讯飞语音识别、语音合成，希望在同一个平台内接入大模型能力
需要按任务难度在多个版本间切换、控制调用成本的团队
做论文问答、学术写作，需要科技文献大模型等垂直版本
需要联网搜索并返回信源标题与地址的问答类应用

不建议选它的情况

项目已经深度绑定讯飞星火 Max 版本，短期内无法承受 26 年 3 月 10 日下线带来的迁移成本
用 Lite 之外的版本会造成浪费
需要 FunctionCall 能力但不愿切换到 HTTP 协议接入的项目

讯飞星火api使用建议

HOW TO USE工具标签

入门先把路子走对

先领免费额度接入前先到产品页面领取免费额度，再到控制台创建应用，拿到 AppID、APIKey、APISecret 三件套，这三个值在调用鉴权时都要用到。
按版本选地址domain 参数与请求 URL 一一对应：Ultra 用 v4.0/chat，Max-32K 用 chat/max-32k，Max 用 v3.5/chat，Pro-128K 用 chat/pro-128k，Pro 用 v3.1/chat，Lite 用 v1.1/chat，选错会鉴权或路由失败。
system 放第一条如需传入 system 参数设置对话背景，必须保证它是 text 数组的第一条，之后按 user、assistant 交替排列；system 仅 Max、Ultra 版本支持。
传输用 wss协议支持 ws(s)，官方强烈推荐 wss。生产环境直接使用 wss 可以避免明文传输 api key 与对话内容带来的安全风险。

进阶省时间也省钱

历史信息要裁剪text 下所有 content 累计 tokens 必须控制在模型上下文长度内，Lite、Pro、Max 上限 8192，超长对话需要主动裁剪旧轮次，否则请求会被拒。
按任务调 temperature默认 0.5，数学、推理、代码类任务官方建议调为 0.6。需要稳定输出时往低走，需要创意发散时往高走，取值范围 (0，1]。
deep 模式要注意消耗联网搜索的 search_mode 默认 normal，切换为 deep 会引用全文回答、结果更准确，但会返回 search_prompt 字段并带来额外的 token 消耗，成本敏感场景先用 normal 验证。
准备 Max 迁移Max 版本套餐将于 26 年 3 月 10 日下线，后端升级为 Ultra、授权用量合并。提前把 domain 从 generalv3.5 改为 4.0Ultra，并重测 max_tokens 与上下文上限。

讯飞星火api适合谁用？

WHO IS IT FOR工具标签

已用讯飞语音能力的团队

多档位成本控制项目

论文问答与写作工具

重度依赖 Max 版本的项目

有条件

Max 套餐将于 26 年 3 月 10 日下线，后端升级为 Ultra、授权用量合并。若已按 Max 的 8192 tokens 上限和价格设计产品，需要重新评估迁移成本。

需要 FunctionCall 的项目

有条件

文档说明如需使用 FunctionCall 功能要改用 HTTP 协议接入，只按本文档走 WebSocket 接入无法覆盖这类工具调用场景。

只想点开就用的普通用户

不推荐

星火 API 面向开发者，调用前必须注册开放平台、创建应用、拿密钥并自行组装请求；没有对话网页界面可以直接上手，普通用户会卡在接入环节。

讯飞星火api优点和缺点

PROS & CONS工具标签

优点

六个通用版本加科技文献大模型，分档覆盖不同上下文长度与成本需求
仅 Pro、Max、Ultra 支持联网搜索，Ultra 与 Max 可返回信源标题和地址
1 token 约等于 1.5 个中文汉字，中文场景 token 折算相对直观
同时开放语音识别、语音合成、语音唤醒等能力，可在同一平台集成
temperature、top_k、max_tokens 等生成参数可调，便于按任务微调

缺点

接入前必须先在控制台获取 AppID、APIKey、APISecret 三件套，门槛高于开箱即用产品
不同版本请求地址与 domain 参数各不相同，切换版本需同步改代码
多轮对话需自行拼接并裁剪历史，Lite、Pro、Max 上下文上限仅 8192 tokens
FunctionCall 需改用 HTTP 协议接入，WebSocket 文档未覆盖
Max 版本套餐将于 26 年 3 月 10 日下线，已接入项目需要迁移
官网未公开各版本的 API 调用单价与免费额度上限

讯飞星火api常见问题

FAQ工具标签

星火 API 怎么计费？

计费包含接口的输入和输出内容，1 token 约等于 1.5 个中文汉字或 0.8 个英文单词。Lite、Pro、Pro-128K、Max、Max-32K、4.0 Ultra 六个版本以及科技文献大模型各版本独立计量 tokens，具体单价需以官方页面为准。

调用前要准备什么？

需要两步：先到产品页面领取免费额度，再去控制台创建应用并获取 AppID、APIKey、APISecret，然后按通用 URL 鉴权文档完成鉴权，才能发起请求。

最多可以传多长的上下文？

分版本限制：4.0 Ultra 和 Max-32K 的 content 累计 tokens 不超过 32768，Pro-128K 不超过 131072，Max、Pro、Lite 不超过 8192。超长对话需要开发者自行裁剪历史信息。

哪个版本支持联网搜索？

仅 Spark Pro、Spark Max 和 Spark Ultra 支持搜索插件，天气、日期类问题依赖搜索。

Max 版本还能用吗？

根据公告，Max 版本套餐将于 26 年 3 月 10 日下线，后端服务将升级为 Ultra 版本，授权用量与 Ultra 合并。已经使用 generalv3.5 的项目需要迁移到 Ultra 的 domain 参数 4.0Ultra。

用 system 角色有什么限制？

system 用于设置对话背景，仅 Max、Ultra 版本支持，且传入时必须保证 text 数组的第一条是 system，之后再按 user、assistant 交替拼接历史对话。

怎么调整回答的随机性？

用 temperature 控制，取值范围 (0，1]，默认 0.5，取值越高随机性越强。数学、推理、代码类任务官方建议调为 0.6，需要稳定一致输出时往低调。

讯飞星火api竞品对比

COMPARISON工具标签

工具	编辑评分	价格	核心功能	平台
讯飞星火api本工具	4.2	计费含输入和输出，各版本独立计量 tokens	六版本独立计量；WebSocket 接入；多轮对话拼接；联网搜索插件	API / Web
讯飞星火	—	未标价	讯飞星火认知大模型官网，新一代认知智能大模型，拥有跨领域的知识和语言理解能力简介科大	Web
讯飞星火公文助手	—	未标价	讯飞星火公文助手是一款基于科大讯飞星火大模型技术的 AI 公文写作助手	—
薏米 AI	—	未标价	puaai 官网,ai 绘画，聊天写作在线网站工具简介一款很好用的 AI 系统，能帮助提高工	—
AiSkyHub	—	未标价	AiSkyHub 无限免费体验 GPT4.0,DALL-E-3,文心4.0,讯飞星火等 AI 大	—
星火讯飞大模型	—	未标价	星火讯飞大模型官网，国产全能型 ai 工具，写作，绘画,ppt...样样精通! 星火讯飞简介	—

继续浏览聊天对话

返回分类目录