讯飞星火V4.0 API可用，需使用新版Bearer Token认证：登录讯飞开放平台→进入「我的应用」→选择应用→点击「V4.0」标签页→「生成Token」获取24小时有效Token；Dify中供应商类型选「Xunfei Spark」，API Key粘贴完整Bearer Token，Base URL填https://spark-api.xf-yun.com/v4.0/chat，模型名必须为「generalv4.0」。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认讯飞星火V4.0 API可用性与密钥获取
讯飞星火控制台已全面升级V4.0接口，旧版AppID+APIKey+APISecret三元组方式已被弃用，必须使用新版Bearer Token认证机制，否则Dify所有请求将返回401错误。
登录讯飞开放平台（https://www.xfyun.cn/），进入「我的应用」→选择目标应用→点击「接口地址」右侧的「V4.0」标签页→在「认证方式」区域点击「生成Token」按钮，系统会自动生成一个有效期为24小时的临时Token。注意：【该Token不可重复使用，过期后必须重新生成】。
复制生成的完整Token字符串（以“Bearer ”开头，含空格），不要手动添加引号或换行符。
在Dify中新增讯飞星火模型供应商
登录Dify管理后台 → 右上角头像 → 【设置】→【模型供应商】→ 点击右上角【+ 添加模型供应商】。
供应商类型选择「Xunfei Spark」（不是OpenAI兼容模式，也不是通用HTTP）；填写名称如「讯飞星火-V4.0-生产」；在API Key字段中粘贴上一步复制的完整Token（含Bearer前缀）；Base URL填写官方V4.0正式地址：https://spark-api.xf-yun.com/v4.0/chat。
这一步不能填错URL，V3.5和V4.0的域名、路径完全不同，填成v3.5地址会导致模型列表加载失败且无任何提示。
配置并启用讯飞星火V4.0为默认推理模型
第一步：保存模型供应商后，刷新页面，在模型供应商列表中找到刚添加的条目，点击右侧【配置模型】按钮。
第二步：在弹出面板中，模型名称填「generalv4.0」（这是讯飞V4.0唯一支持的模型标识，填错将触发404）；上下文长度建议设为8192；温度值保持默认0.5即可。
第三步：勾选「启用」开关 → 点击【保存】→ 返回模型供应商列表，确认状态显示为「已启用」。
第四步：进入【设置】→【模型设置】→ 在「系统推理模型」下拉菜单中，选择你刚配置的「讯飞星火-V4.0-生产」→ 点击【保存设置】。
【此操作不可跳过，否则新建应用仍会使用未配置的默认模型，导致对话始终报错】。
验证配置是否生效
方法一：新建一个「聊天助手」应用，不改任何设置，直接点击右上角【发布】→ 进入应用界面发送“你好”，若收到正常回复且左下角显示模型为「generalv4.0」，即成功。
方法二：进入【日志】→【平台日志】→ 筛选类型为「model_provider」，查找最近10分钟内含“spark-api.xf-yun.com”的INFO级别日志，看到status=200且response_time
如果出现“invalid_token”错误，请立即回到第一步重新生成Token并更新API Key字段——这是当前90%以上配置失败的根源。
