provider
iFLYTEK Spark
直接答案讯飞星火的通用 HTTP API、Spark-X1.5 与 Spark-X2 使用不同 Base URL;官方直连使用对应服务的 APIPassword,本站统一使用本站 Bearer 令牌和已适配路径。
更新 · 审核信息
先分清官方直连与本站网关
官方直连使用讯飞控制台为具体服务生成的 APIPassword,并放在 Bearer 鉴权中;本站调用使用本站 Base URL 和本站 Bearer 令牌。本站本页仅声明 /v1/chat/completions,官方的 /v2、/x2 或旧 WebSocket 地址不是本站入口。
版本、路径与模型值
官方通用 HTTP Base URL 为 https://spark-api-open.xf-yun.com/v1,Spark-X1.5 为 /v2,Spark-X2 为 /x2。通用模型还使用特定值,例如 Ultra=4.0Ultra、Max=generalv3.5、Pro=generalv3;X2/X1.5 可使用 spark-x。这里没有通用的 Endpoint ID 可代替这些值,必须把服务 URL、凭证和 model/domain 当作一组核对。本站则填写本站模型列表中的名称,渠道可能负责映射。
流式、思考与工具
官方 HTTP 流采用 SSE 并以 [DONE] 结束。Spark-X2 可返回 reasoning_content,并支持 thinking=enabled|disabled|auto;工具和搜索能力随版本变化,X2 文档明确 function 与 web_search 不能同时传入。应用仍需自行执行函数,并校验参数和权限。
错误与费用安全
业务码可能分别表示未结束请求、token 超限、日限额、秒级频率或并发限制,不能只看 HTTP 状态。限制重试次数,设置并发、超时、最大输出和账户告警;联网搜索或深度搜索可能增加 token 消耗。套餐和产品会升级,价格与配额以当前控制台和官方公告为准。
上线前核验
确认使用的是 HTTP 而非旧 WebSocket 凭证,核对版本路径、APIPassword、model/domain、上下文和工具矩阵。通过本站时再核对本站模型列表和渠道适配,不要把官方 model 值误当成本站一定存在的别名。
已核验厂商目录
按能力类型查看最新模型
这里展示厂商官方目录中的具体型号,不代表本站一定已开放;可调用 ID、端点和价格请以模型广场为准。
文本、推理与代码
-
spark-x稳定讯飞星火 X2 的正式请求型号;需配合 X2 专用 Base Path,避免路由到旧版。
-
xsparkx2agent稳定Astron Coding Plan 面向代理式编码的 Spark X2 Agent 型号。
-
xsparkx2flash稳定Astron Coding Plan 中强调速度与吞吐的 Spark X2 Flash 型号。
适用场景
- 中文对话与推理
- 函数调用
- OpenAI 兼容接口
API 协议
/v1/chat/completions
FAQ
为什么官方 APIPassword 不能直接填到本站?
APIPassword 是讯飞官方直连凭证,只能用于对应官方服务;本站 /v1/chat/completions 使用本站签发的 Bearer 令牌。若由管理员配置讯飞渠道,应把官方凭证配置在渠道侧,客户端不要混用两类密钥。
Spark-X2 为什么不能沿用通用 /v1 地址?
官方通用 HTTP Base URL 是 https://spark-api-open.xf-yun.com/v1,Spark-X1.5 使用 /v2,Spark-X2 使用 /x2;X2/X1.5 的 model 可为 spark-x。这些是官方直连路径,本站仍只使用本页声明的 /v1/chat/completions。
产品名、model 和 domain 应该怎么对应?
它们不是可互换的展示名称。通用服务示例中 Ultra 对应 4.0Ultra、Max 对应 generalv3.5、Pro 对应 generalv3;X2/X1.5 还由 URL 版本区分。复制请求前应同时核对该服务的 URL、APIPassword 和 model/domain。
关联指南
官方来源
- 讯飞星火 HTTP API 文档 Official
- 讯飞星火 Spark-X2 / X1.5 HTTP API 文档 Official
兔子API