讯飞星火接入
这篇解决什么
星火平台字符串怎么填、x2 和 x2-flash 各打哪个地址。读完能对上 AiPlatformEnum.XING_HUO = "XingHuo",以及工厂建客户端时不读密钥 url。
默认端口 48080。开启见 AI 功能设计。
示意图:同一包装类按模型名选 Base URL。出站时模型名会被改成 spark-x。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 密钥 | @RequestMapping("/ai/api-key") | ruoyi-office/yudao-module-ai/.../controller/admin/model/AiApiKeyController.java |
| 工厂 | buildXingHuoChatModel(apiKey) | AiModelFactoryImpl |
| 包装 | MODEL_X2 / MODEL_X2_FLASH | XingHuoChatModel |
| 选项 | DeepSeekChatOptions | AiUtils.buildChatOptions |
官方菜单:密钥 2761,模型 2767。
默认模型是 x2-flash。业务模型只认 x2 和 x2-flash:前者打 https://spark-api-open.xf-yun.com/x2,后者打 https://spark-api-open.xf-yun.com/agent/v1。真正发给讯飞的 model 字段会被改成 spark-x。
/draw 没有 XingHuo 分支。对话用 type=1。
字段
| 名称 | 说明 | 仓库路径 |
|---|---|---|
platform | 必须是 XingHuo | AiApiKeyDO / AiModelDO |
apiKey | 讯飞开放平台密钥 | AiApiKeyDO |
model | x2 或 x2-flash | AiModelDO |
不是 Spark 也不是 XfYun
枚举值是 XingHuo。工厂不读密钥 url,换地址改代码里的两套 Base URL,不要指望在密钥页填主机。
模型名不要填成 spark-x
库表写 x2 / x2-flash 用来选主机。spark-x 是包装类出站时改的,写进 ai_model.model 选不中 Flash 那条。
按本仓库 DO 生成的 ER。
配置与操作
走 API 密钥(2761)建 platform=XingHuo(不是 Spark)。工厂建客户端不读密钥 url。x2 与 x2-flash 各打各的地址,以模型名为准。
再在 模型配置 建 type=1。开启见 AI 功能设计。

本系统截图:AI 大模型 → 控制台 → API 密钥。各厂商共用这一页,用 platform 区分。

本系统截图:控制台 → 模型配置。keyId 必须指向同平台密钥。
