一、MiniMax 嵌入
Spring AI 支持 MiniMax 提供的多种 AI 语言模型。您可以与 MiniMax 语言模型进行交互，并基于 MiniMax 模型创建多语言对话助手。
二、先决条件
您需要创建 MiniMax 的 API 来访问其语言模型。
在 MiniMax 注册页面 创建账户。
在 API 密钥页面 生成令牌。
Spring AI 项目定义了一个名为 spring.ai.minimax.api-key 的配置属性，您应将其设置为从 API 密钥页面获取的 API 密钥值。
您可以在 application.properties 文件中设置此配置属性：
spring.ai.minimax.api-key=<your-minimax-api-key>为了在处理敏感信息（如 API 密钥）时增强安全性，您可以使用 Spring 表达式语言（SpEL）来引用环境变量：
# 在 application.yml 中spring:ai:minimax:api-key:${MINIMAX_API_KEY}# 在您的环境或 .env 文件中exportMINIMAX_API_KEY=<your-minimax-api-key>您也可以在应用程序代码中以编程方式设置此配置：
// 从安全源或环境变量检索 API 密钥StringapiKey=System.getenv("MINIMAX_API_KEY");2.1 添加仓库和 BOM
Spring AI 工件发布在 Maven Central 和 Spring Snapshot 仓库中。请参阅 工件仓库 部分，将这些仓库添加到您的构建系统中。
为了帮助管理依赖项，Spring AI 提供了一个 BOM（物料清单）来确保在整个项目中使用一致的 Spring AI 版本。请参阅 依赖管理 部分，将 Spring AI BOM 添加到您的构建系统中。
三、自动配置
Spring AI 的自动配置和 starter 模块的工件名称发生了重大变化。更多信息请参阅 升级说明。
Spring AI 为 MiniMax 嵌入模型提供了 Spring Boot 自动配置。要启用它，请将以下依赖项添加到项目的 Maven pom.xml 文件中：
<dependency><groupId>org.springframework.ai</groupId><artifactId>spring-ai-starter-model-minimax</artifactId></dependency>或添加到您的 Gradle build.gradle 构建文件中：
dependencies{implementation'org.springframework.ai:spring-ai-starter-model-minimax'}请参阅 依赖管理 部分，将 Spring AI BOM 添加到您的构建文件中。
3.1 嵌入属性
3.1.1 重试属性
前缀 spring.ai.retry 用作属性前缀，用于配置 MiniMax 嵌入模型的重试机制。
3.1.2 连接属性
前缀 spring.ai.minimax 用作属性前缀，用于连接到 MiniMax。
3.1.3 配置属性
嵌入自动配置的启用和禁用现在通过顶级属性 spring.ai.model.embedding 前缀进行配置。
要启用：spring.ai.model.embedding=minimax（默认启用）
要禁用：spring.ai.model.embedding=none（或任何与 minimax 不匹配的值）
进行此更改是为了允许配置多个模型。
前缀 spring.ai.minimax.embedding 是用于配置 MiniMax 的 EmbeddingModel 实现的属性前缀。
您可以为 ChatModel 和 EmbeddingModel 实现覆盖通用的 spring.ai.minimax.base-url 和 spring.ai.minimax.api-key。如果设置了 spring.ai.minimax.embedding.base-url 和 spring.ai.minimax.embedding.api-key 属性，则它们优先于通用属性。类似地，如果设置了 spring.ai.minimax.chat.base-url 和 spring.ai.minimax.chat.api-key 属性，则它们优先于通用属性。如果您想为不同模型和不同模型端点使用不同的 MiniMax 账户，这会很有用。
所有以 spring.ai.minimax.embedding.options 为前缀的属性都可以在运行时通过向 EmbeddingRequest 调用添加请求特定的 运行时选项 来覆盖。
四、运行时选项
MiniMaxEmbeddingOptions.java 提供了 MiniMax 的配置，例如要使用的模型等。
默认选项也可以使用 spring.ai.minimax.embedding.options 属性进行配置。
在启动时，使用 MiniMaxEmbeddingModel 构造函数来设置用于所有嵌入请求的默认选项。在运行时，您可以使用 MiniMaxEmbeddingOptions 实例作为 EmbeddingRequest 的一部分来覆盖默认选项。
例如，为特定请求覆盖默认模型名称：
EmbeddingResponseembeddingResponse=embeddingModel.call(newEmbeddingRequest(List.of("Hello World","World is big and salvation is near"),MiniMaxEmbeddingOptions.builder().model("Different-Embedding-Model-Deployment-Name").build()));五、示例控制器
这将创建一个 EmbeddingModel 实现，您可以将其注入到您的类中。下面是一个简单的 @Controller 类示例，它使用 EmbeddingModel 实现。
spring.ai.minimax.api-key=YOUR_API_KEY spring.ai.minimax.embedding.options.model=embo-01@RestControllerpublicclassEmbeddingController{privatefinalEmbeddingModelembeddingModel;@AutowiredpublicEmbeddingController(EmbeddingModelembeddingModel){this.embeddingModel=embeddingModel;}@GetMapping("/ai/embedding")publicMapembed(@RequestParam(value="message",defaultValue="给我讲个笑话")Stringmessage){EmbeddingResponseembeddingResponse=this.embeddingModel.embedForResponse(List.of(message));returnMap.of("embedding",embeddingResponse);}}六、手动配置
如果不使用 Spring Boot，您可以手动配置 MiniMax 嵌入模型。为此，请将 spring-ai-minimax 依赖项添加到项目的 Maven pom.xml 文件中：
<dependency><groupId>org.springframework.ai</groupId><artifactId>spring-ai-minimax</artifactId></dependency>或添加到您的 Gradle build.gradle 构建文件中：
dependencies{implementation'org.springframework.ai:spring-ai-minimax'}请参阅 依赖管理 部分，将 Spring AI BOM 添加到您的构建文件中。
spring-ai-minimax 依赖项还提供了对 MiniMaxChatModel 的访问权限。有关 MiniMaxChatModel 的更多信息，请参阅 MiniMax 聊天客户端 部分。
接下来，创建一个 MiniMaxEmbeddingModel 实例并使用它来计算两个输入文本之间的相似性：
varminiMaxApi=newMiniMaxApi(System.getenv("MINIMAX_API_KEY"));varembeddingModel=newMiniMaxEmbeddingModel(minimaxApi,MetadataMode.EMBED,MiniMaxEmbeddingOptions.builder().model("embo-01").build());EmbeddingResponseembeddingResponse=this.embeddingModel.embedForResponse(List.of("Hello World","World is big and salvation is near"));MiniMaxEmbeddingOptions 提供嵌入请求的配置信息。选项类提供了一个 builder() 用于轻松创建选项。
