重要通知：spring-ai-hunyuan 已兼容 Spring AI 稳定版！

最新推荐文章于 2025-08-04 20:17:21 发布

转载最新推荐文章于 2025-08-04 20:17:21 发布 · 13 阅读

文章标签：

1. 重要通知：spring-ai-hunyuan 已兼容 Spring AI 稳定版！ 06-19

最近有小伙伴在使用 mvn 仓库中的 1.0.0-M6 版本时，已经遇到一些兼容性问题和未知异常。本着更好地维护 spring-ai-hunyuan 仓库，我这几天熬夜更新并整理了对 Spring AI 稳定版（即 1.0.0）的支持。

项目源码地址：
👉 https://github.com/StudiousXiaoYu/spring-ai-hunyuan

当前已支持的功能包括：
✅ Chat（支持流式回答与图片理解）
✅ Embedding （文本向量生成）

混元官方的其他能力我也会逐步实现，欢迎更多小伙伴试用并通过 issue 提出反馈。如果一时联系不上我，也可以直接在相关文章下方留言，我会定期查看并及时回复。

如何使用#

环境准备#

确保你已安装以下工具：

✅ JDK 17+
✅ Maven 3.8+
✅ 腾讯云账号 + HunYuan 秘钥（Secret ID / Secret Key）

创建 Spring Boot 项目并集成#

在你的 Spring Boot 项目中添加如下依赖（以 pom.xml 为例）：

<dependency>
    <groupId>io.github.studiousxiaoyu</groupId>
    <artifactId>spring-ai-starter-model-hunyuan</artifactId>
    <version>1.0.0</version>
</dependency>

配置 HunYuan 参数#

在 application.properties 或 application.yml 中添加 HunYuan 认证信息和模型配置：

spring.ai.hunyuan.secret-id=你的-secret-id
spring.ai.hunyuan.secret-key=你的-secret-key
spring.ai.hunyuan.chat.options.model=hunyuan-pro
spring.ai.hunyuan.embedding.options.model=hunyuan-embedding
spring.ai.hunyuan.embedding.options.dimensions=1024

编写测试代码#

使用 ChatClient 发起对话

public class HunYuanService {

    private final ChatClient chatClient;

    public HunYuanService(ChatClient chatClient) {
        this.chatClient = ChatClient.builder(chatModel).build();
    }

    public String askQuestion(String question) {
        return chatClient.prompt()
                .user(question)
                .call()
                .content();
    }
}

控制器示例

@RestController
@RequestMapping("/chat")
public class ChatController {

    private final HunYuanService hunYuanService;

    public ChatController(HunYuanService hunYuanService) {
        this.hunYuanService = hunYuanService;
    }

    @GetMapping("/q")
    public String chat(@RequestParam("text") String text) {
        return hunYuanService.askQuestion(text);
    }
}