QianFan

QianFan Image Generation

Spring AI 支持来自 QianFan 的图像生成模型 CogView。

先决条件

您需要使用 QianFan 创建 API 密钥才能访问其 AI 模型。

在QianFan 注册页面创建一个帐户，并在API Keys 页面 生成令牌。

Spring AI 项目定义了一个属性名为 spring.ai.qianfan.api-key 的配置，您应该将其设置为从 QianFan 获取的 API Key 值。

导出环境变量是设置该配置属性的一种方法：

export SPRING_AI_QIANFAN_API_KEY=<INSERT KEY HERE>

自动配置

Spring AI 为 QianFan Chat Client 提供 Spring Boot 自动配置。要启用它，请将以下依赖项添加到项目的 Maven pom.xml 文件中：

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-qianfan-spring-boot-starter</artifactId>
</dependency>

或者，在你的 Gradle 构建文件 build.gradle 中添加：

dependencies {
    implementation 'org.springframework.ai:spring-ai-qianfan-spring-boot-starter'
}

配置属性

连接属性

spring.ai.qianfan 前缀的属性，可让您配置 QianFan 的连接。

图像生成属性

spring.ai.qianfan.image 前缀的属性，可让您配置 QianFan 的 ImageClient 实现。

重试属性

spring.ai.retry 前缀的属性，可让您配置 QianFan Image client 的重试机制。

Runtime Options

QianFanImageOptions.java 提供模型配置，例如要使用的模型、样式、大小等。

启动时，可以使用 QianFanImageClient(QianFanImageApi qianFanImageApi) 构造函数和 withDefaultOptions(QianFanImageOptions defaultOptions) 方法配置默认选项。或者，使用 spring.ai.qianfan.image.options.* 前缀描述的属性。

在运行时，您可以通过向调用添加新的、特定于请求的选项来覆盖 ImagePrompt 的默认选项。例如，要覆盖 QianFan 特定选项（例如质量和要创建的图像数量），请使用以下代码示例：

ImageResponse response = qianFanImageModel.call(
        new ImagePrompt("A light cream colored mini golden doodle",
        QianFanImageOptions.builder()
                .withN(4)
                .withHeight(1024)
                .withWidth(1024).build())

);

注意：除了特定于模型的 QianFanImageOptions 之外，您还可以使用 ImageOptionsBuilder#builder() 创建的可移植ImageOptions 实例。