讯飞星火API是否免费？实测额度、价格与接入避坑
上周三晚上十一点，一个做教育 SaaS 的老同学在微信上把我薅起来：他们想给学生作业系统加一个 AI 批改功能，预算只有几百块，问我「讯飞星火 API 是不是免费的」。这个问题我这两年至少被问过七八次，但每次回答都得先反问一句——你说的是哪个版本？
因为讯飞星火 API 是否免费，答案不是简单的「是」或「否」，而是取决于你调的是 Lite、Pro、Max 还是 4.0 Ultra。我把手上项目里用过的几个版本翻出来重新跑了一遍，顺手把控制台的价格页也扒了一遍，写成这篇东西。
核心结论：讯飞星火 API 是「分层免费」，不是「全免费」。Spark Lite 长期免费且不限调用量，适合学习和低频原型验证；Spark Pro、Max、4.0 Ultra 走按 Token 计费，新用户注册实名后可领一次性赠送额度。个人项目基本够用，商用高并发必须做预算。
先说清楚：星火 API 的「免费」到底免在哪
讯飞星火是指科大讯飞推出的认知大模型系列，走开放平台（xfyun.cn）对外提供 API，属于国产大模型里起步较早、版本迭代比较密的一支。它的计费模型跟大部分厂商一样，按 Token 计费——输入和输出分开算，1 个中文汉字大约对应 1~1.5 个 Token。
真正让「讯飞星火 API 是否免费」这个问题变复杂的，是讯飞把模型拆成了好几个档位，每个档位的免费政策完全不同。你如果只看官网首页那句「免费使用」，大概率会误判。
我这边的实测结论是：
- **Lite 是真的免费**，没有调用量上限，但有 QPS 和并发限制，适合个人调试、脚本任务、内部工具。
- **Pro 及以上是收费的**，只不过新用户有一次性赠送额度，用完了就得充值。
- **赠送额度不是按月刷新**，用完就没了，这点和某些云厂商的「每月免费额度」逻辑不一样，很多人第一次会搞混。
各版本免费额度与计费边界对照
下面这张表是我按控制台信息和实际账单整理的，价格讯飞调整过好几轮，具体数字请以官方价格页为准，但量级和免费政策是稳定的：
| 模型版本 | 计费方式 | 免费政策 | 典型适用场景 | | --- | --- | --- | --- | | Spark Lite | 免费 | 长期免费，不限调用量，有 QPS 限制 | 学习练手、原型验证、低频工具 | | Spark Pro | 按 Token 计费 | 新用户赠送额度，注册实名后领取 | 通用问答、文案生成、摘要 | | Spark Max | 按 Token 计费 | 赠送额度较少 | 长文本理解、复杂指令跟随 | | Spark 4.0 Ultra | 按 Token 计费 | 赠送额度最少 | 高难度推理、专业领域任务 | | Spark X1（深度推理） | 按 Token 计费 | 活动/时段性赠送 | 数学、代码、链式推理 |
有个容易被忽略的点：免费额度是针对账号的，不是针对模型的。也就是说，你注册一个个人账号，能领到的赠送总量是固定的，Pro 花掉一部分，Max 那边就少一部分。我当初第一次接入时以为每个模型各送一份，结果写完 Demo 一测，Pro 的额度直接见底了。
从成本角度看，如果你只是跑个每天几百次调用的内部工具，Lite 完全够；一旦涉及 C 端面向用户的产品，就得认真算账了——单次对话按 1000 Token 估算，日活一万、人均 5 轮对话的话，一天就是 5000 万 Token 的消耗量，这个量级下「免费」两个字基本和你无关。
技术拆解：两套接入协议与鉴权差异
星火 API 目前对外有两套接入方式，这是新手最容易翻车的地方，我先讲清楚区别。
第一套是 HTTP 接口，兼容 OpenAI 格式。 这是目前最推荐的路径，因为它意味着你可以直接复用 OpenAI SDK，改两行配置就能跑。鉴权用的是控制台里那一长串 API Password，作为 Bearer Token 传。
第二套是 WebSocket 接口，老版本协议。 需要用 app_id + api_key + api_secret 三个字段做 HMAC 签名，把签名拼到 URL 上。星火早期文档全是这套，现在很多老教程还在讲它，照着抄容易跟新版本控制台对不上号。
一个能直接跑的 Python 示例（HTTP 兼容模式）：
依赖：pip install openai
from openai import OpenAI
client = OpenAI(
控制台「星火认知大模型」页面里的 API Password，注意不是 api_secret
api_key="你的APIPassword", base_url="https://spark-api-open.xf-yun.com/v1" )
resp = client.chat.completions.create( model="lite", # 免费版填 lite；Pro 填 generalv3.5；Ultra 填 4.0Ultra messages=[ {"role": "system", "content": "你是一个简洁的技术助手"}, {"role": "user", "content": "用一句话解释什么是大模型推理"} ], temperature=0.7, stream=False )
print(resp.choices[0].message.content)
代码本身没什么玄机，真正的坑在 `model` 参数上。小写 `lite`、`generalv3.5`、`4.0Ultra`、`max-32k` 这些字符串是硬编码的，写错一个字母就会返回鉴权类或参数类错误码，而报错信息往往不会告诉你「模型名不存在」，只会丢一个笼统的失败提示。我第一次调 Max 的时候卡了四十分钟，最后发现是把 `max-32k` 写成了 `max_32k`。
另外，如果你的场景涉及多模态大模型能力（比如图片理解、文档 OCR），调用方式是在 messages 里塞 image 类型的 content 块，模型侧会自动路由到对应的多模态通道，但计费口径和纯文本不一致，需要单独看说明。
实战场景：哪些项目真能用免费额度跑起来
聊完协议，回到最实际的问题——什么项目可以只靠 Lite 活下去。
我自己的经验是这样的：决策类、辅助类、异步类场景可以，交互类、高并发类场景不行。
举几个我实际跑过或见过的例子：
可以白嫖的：
- 个人知识库的离线批处理，比如把一批 Markdown 笔记过一遍生成摘要，一天跑一次，用 Lite 完全无压力
- 内部运维脚本的自然语言解析，把「帮我把上周的日志按错误类型分组」这种指令转成结构化参数
- 学习阶段的 Prompt 调试，反正 Lite 不限量，随便试
别指望免费的：
- 面向 C 端的实时对话产品，Lite 的 QPS 上限会直接卡死体验
- 需要长上下文的任务，Lite 的上下文窗口相对有限，长文档摘要必须上 Pro 或 Max
- 涉及复杂推理链的场景，比如数学题、多步代码生成，Lite 的准确率掉得比较明显，得靠 X1 或 Ultra
坦白讲，我自己在做一个合同条款比对的小工具时，一开始全程用 Lite，效果只能说「勉强能用」——简单条款没问题，遇到嵌套的免责条款就开始胡编。换成 Pro 之后准确率肉眼可见地提升，但成本也上来了。这就是典型的「免费和效果不可兼得」。
我踩过的坑，以及几个省钱的实操建议
接入过程中有几个坑我觉得值得单独拎出来说。
坑一：把 API Password 和 API Secret 搞混。 控制台里这两个字段挨得很近，HTTP 兼容模式要的是前者，WebSocket 模式要的是后者加签名。用错了会一直返回鉴权失败，而且没有明确提示。
坑二：忘记开模型授权。 讯飞的模型需要在控制台手动「开通」或「授权」到你的应用上，不开通直接调，接口会报无权限。这个设计在多模型平台里挺常见的，但第一次用的人几乎都会中招。
坑三：没设 Token 上限就上线。 赠送额度是会被跑完的，而且跑完之后如果账号绑了支付方式，会直接转成扣费。上线前一定要在代码里对 `max_tokens` 做限制，并且加一层本地用量统计。
省钱建议就三条：先用 Lite 验证 Prompt 逻辑，再切贵模型做效果对比；对相同 Prompt 做本地缓存，重复请求直接命中缓存；把非实时任务挪到夜间批处理，避免高峰期并发被限。
顺手提一下，我在挑模型的时候习惯先到 VergeX AI 工具导航 上对一遍各家国产大模型的定价和免费政策，比一个个翻官网快得多。
总结与学习路径
讯飞星火 API 是否免费，答案取决于三点：你调哪个模型、你调多少量、你用来做什么。Lite 长期免费这条路是真实存在的，而且对个人开发者相当友好——这一点我觉得比很多「免费额度只有 100 万 Token」的厂商实在。但一旦跨过 Lite 的边界，它就是一个标准的商业 API，按 Token 计费，该花的钱一分不少。
如果你是刚入门，我建议的路径是：先用 Lite 把 OpenAI 兼容格式的调用跑通，理解 messages 结构和 Token 概念；然后拿同一个 Prompt 在 Lite 和 Pro 上各跑 20 次，做一次效果和成本的对比；最后再决定你的产品该用哪个档位。这个流程走完，你对「成本」这件事的感知会比看十篇定价页都强。
未来我比较关注的是 X1 这类深度推理模型的定价走向。推理模型的 Token 消耗天然比普通模型高——它会输出很长的思维链——如果价格下不来，深度推理能力在中小团队里的普及速度会明显慢于预期。
关键要点速览
- Spark Lite 长期免费、不限调用量，但有 QPS 和并发限制，适合原型与低频场景
- Pro / Max / 4.0 Ultra / X1 均按 Token 计费，新用户赠送额度为账号级一次性，用完即止
- 推荐走 HTTP 兼容 OpenAI 的接入方式，鉴权用 API Password；WebSocket 老协议需三字段签名
- `model` 参数名是硬编码字符串，写错会报模糊错误，是新手最高频的翻车点
- 生产环境务必设置 max_tokens 上限与本地用量统计，防止额度耗尽后自动转扣费
相关推荐
阅读相关专题 想系统了解国产大模型的选型与成本对比，可以继续浏览 VergeX 的大模型专题，我们把主流厂商的定价、上下文窗口和推理能力做了横向整理。
查看工具推荐 正在挑模型或 API 平台？到 VergeX AI 工具导航 看看分类整理的国产大模型与开发工具清单，省去一个个翻官网的时间。
订阅更新 大模型定价变动频繁，我们会持续跟踪各家 API 的免费政策与价格调整。订阅 VergeX 更新，第一时间收到变动提醒。