讯飞星火（Spark）
科大讯飞自研大模型，Spark Lite 官方标注为免费模型，中文与语音能力见长
2026/08/30 已核实
前往官方平台 ↗
额度速览
Spark Lite
官方产品页标注为免费模型，需领取后使用（具体额度与速率限制以控制台为准）
新用户免费额度包
注册后在星火产品页领取，可用于 Spark Pro / Max / Ultra 等付费模型，额度以官方实时发放为准
实名认证加赠
完成实名认证额外加赠 50 万 Token（30 天有效）
领取步骤
- 1 访问 xinghuo.xfyun.cn 或 xfyun.cn 注册讯飞开放平台账号
- 2 进入控制台创建应用，拿到 AppID、APIKey、APISecret
- 3 在星火产品页领取 Spark Lite 免费模型额度与新用户免费包
- 4 按官方 WebSocket / HTTP 文档接入，或用官方 SDK（Python / Java / JS / Go 等）
怎么用
接口为官方 WebSocket 自定义协议，不兼容 OpenAI SDK。接入端点：wss://spark-api.xf-yun.com/v1.1/chat
domain：lite，鉴权用 AppID / APIKey / APISecret（可用模型以官方列表为准）
cURL
# 该平台为 WebSocket 自定义协议，不支持 cURL 直连
# 接入端点（示例模型）：wss://spark-api.xf-yun.com/v1.1/chat
# domain 参数：lite
# 鉴权三件套：AppID / APIKey / APISecret（控制台创建应用后获取）
# 完整文档：https://www.xfyun.cn/doc/spark/Web.htmlPython（官方 SDK）
# 安装官方 SDK：pip install --upgrade spark_ai_python
from sparkai.llm.llm import ChatSparkLLM, ChunkPrintHandler
from sparkai.core.messages import ChatMessage
SPARKAI_URL = 'wss://spark-api.xf-yun.com/v1.1/chat'
SPARKAI_APP_ID = '你的 AppID'
SPARKAI_API_SECRET = '你的 APISecret'
SPARKAI_API_KEY = '你的 APIKey'
SPARKAI_DOMAIN = 'lite'
if __name__ == '__main__':
spark = ChatSparkLLM(
spark_api_url=SPARKAI_URL,
spark_app_id=SPARKAI_APP_ID,
spark_api_key=SPARKAI_API_KEY,
spark_api_secret=SPARKAI_API_SECRET,
spark_llm_domain=SPARKAI_DOMAIN,
streaming=False,
)
messages = [ChatMessage(role="user", content='你好，介绍一下你自己')]
handler = ChunkPrintHandler()
resp = spark.generate([messages], callbacks=[handler])
print(resp)喜欢图形界面？看教程《领取第一个免费 Key 并接入 Cherry Studio》。 API 文档：https://www.xfyun.cn/doc/spark/Web.html ↗
附加端点
部分套餐（如 Coding Plan）有专用接入端点，配置时注意区分：
Spark Pro（generalv3）
wss://spark-api.xf-yun.com/v3.1/chat Spark Pro-128K
wss://spark-api.xf-yun.com/chat/pro-128k Spark Ultra（4.0 Ultra）
wss://spark-api.xf-yun.com/v4.0/chat HTTP 调用文档
https://www.xfyun.cn/doc/spark/HTTP.html WebSocket 调用文档
https://www.xfyun.cn/doc/spark/Web.html ⚠️ 坑点提醒
- Spark Lite 免费但有并发与速率限制，高峰期可能排队；官方文档注明并发提升需联系商务
- Lite 之外的模型（Pro / Ultra / X2）按量计费或走 Token Plan，免费额度用尽即扣费，注意切回 Lite
- 讯飞星火是 WebSocket + 自定义鉴权协议，不是 OpenAI 兼容格式，迁移现有代码需要适配
- Max 版本官方已于 2026-03-10 下线并合并至 Ultra，注意 domain 与 endpoint 已变更
- 1 token ≈ 1.5 个中文汉字 / 0.8 个英文单词，估算成本时别按字符数算