MiniMax 聊天

Spring AI 支持 MiniMax 的各种 AI 语言模型。您可以与 MiniMax 语言模型交互，并基于 MiniMax 模型创建多语言对话助手。

先决条件

您需要使用 MiniMax 创建一个 API 以访问 MiniMax 语言模型。

在 MiniMax 注册页面创建账户，并在 API Key 页面生成令牌。Spring AI 项目定义了一个名为 spring.ai.minimax.api-key 的配置属性，您应将其设置为从 API Key 页面获得的 API Key 的值。导出环境变量是设置此配置属性的一种方法

export SPRING_AI_MINIMAX_API_KEY=<INSERT KEY HERE>

添加仓库和 BOM

Spring AI artifacts 发布在 Maven Central 和 Spring Snapshot 仓库中。请参阅 仓库 部分，将这些仓库添加到您的构建系统。

为了帮助进行依赖管理，Spring AI 提供了一个 BOM (bill of materials)，以确保在整个项目中使用的 Spring AI 版本一致。请参阅 依赖管理 部分，将 Spring AI BOM 添加到您的构建系统。

自动配置

Spring AI 自动配置、starter 模块 artifact 名称发生了重大变化。请参阅 升级注意事项 了解更多信息。

Spring AI 为 MiniMax Embedding 模型提供了 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 添加到您的构建文件。

Embedding 属性

重试属性

前缀 spring.ai.retry 用作属性前缀，允许您配置 MiniMax Embedding 模型的重试机制。

属性 描述 默认值

spring.ai.retry.max-attempts

最大重试次数。

10

spring.ai.retry.backoff.initial-interval

指数退避策略的初始等待时长。

2 秒

spring.ai.retry.backoff.multiplier

退避间隔乘数。

5

spring.ai.retry.backoff.max-interval

最大退避时长。

3 分钟

spring.ai.retry.on-client-errors

如果为 false，则抛出 NonTransientAiException，并且不对 4xx 客户端错误码进行重试。

false

spring.ai.retry.exclude-on-http-codes

不应触发重试的 HTTP 状态码列表（例如，抛出 NonTransientAiException）。

空

spring.ai.retry.on-http-codes

应触发重试的 HTTP 状态码列表（例如，抛出 TransientAiException）。

空

连接属性

前缀 spring.ai.minimax 用作属性前缀，允许您连接到 MiniMax。

属性 描述 默认值

spring.ai.minimax.base-url

连接 URL

api.minimax.chat

spring.ai.minimax.api-key

API Key

-

配置属性

现在通过前缀为 spring.ai.model.embedding 的顶级属性来配置 Embedding 自动配置的启用和禁用。

要启用，请设置 spring.ai.model.embedding=minimax (默认启用)

要禁用，请设置 spring.ai.model.embedding=none (或任何不匹配 minimax 的值)

进行此更改是为了允许配置多个模型。

前缀 spring.ai.minimax.embedding 是属性前缀，用于配置 MiniMax 的 EmbeddingModel 实现。

属性 描述 默认值

spring.ai.minimax.embedding.enabled (已移除，不再有效)

启用 MiniMax Embedding 模型。

true

spring.ai.model.embedding

启用 MiniMax Embedding 模型。

minimax

spring.ai.minimax.embedding.base-url

可选，覆盖 spring.ai.minimax.base-url 以提供特定于 Embedding 的 URL

-

spring.ai.minimax.embedding.api-key

可选，覆盖 spring.ai.minimax.api-key 以提供特定于 Embedding 的 API Key

-

spring.ai.minimax.embedding.options.model

要使用的模型

embo-01
您可以为 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 构造函数设置用于所有 Embedding 请求的默认选项。在运行时，您可以使用 MiniMaxEmbeddingOptions 实例作为 EmbeddingRequest 的一部分来覆盖默认选项。

例如，为特定请求覆盖默认模型名称

EmbeddingResponse embeddingResponse = embeddingModel.call(
    new EmbeddingRequest(List.of("Hello World", "World is big and salvation is near"),
        MiniMaxEmbeddingOptions.builder()
            .model("Different-Embedding-Model-Deployment-Name")
        .build()));

示例 Controller

这将创建一个 EmbeddingModel 实现，您可以将其注入到您的类中。以下是一个使用 EmbeddingC 实现的简单 @Controller 类示例。

spring.ai.minimax.api-key=YOUR_API_KEY
spring.ai.minimax.embedding.options.model=embo-01
@RestController
public class EmbeddingController {

    private final EmbeddingModel embeddingModel;

    @Autowired
    public EmbeddingController(EmbeddingModel embeddingModel) {
        this.embeddingModel = embeddingModel;
    }

    @GetMapping("/ai/embedding")
    public Map embed(@RequestParam(value = "message", defaultValue = "Tell me a joke") String message) {
        EmbeddingResponse embeddingResponse = this.embeddingModel.embedForResponse(List.of(message));
        return Map.of("embedding", embeddingResponse);
    }
}

手动配置

如果您不使用 Spring Boot，可以手动配置 MiniMax Embedding 模型。为此，请将 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 实例，并使用它来计算两个输入文本之间的相似度

var miniMaxApi = new MiniMaxApi(System.getenv("MINIMAX_API_KEY"));

var embeddingModel = new MiniMaxEmbeddingModel(minimaxApi, MetadataMode.EMBED,
MiniMaxEmbeddingOptions.builder().model("embo-01").build());

EmbeddingResponse embeddingResponse = this.embeddingModel
	.embedForResponse(List.of("Hello World", "World is big and salvation is near"));

MiniMaxEmbeddingOptions 提供了 Embedding 请求的配置信息。选项类提供了 builder() 方法，方便创建选项。