ZhiPuAI图像生成
Spring AI 支持来自智谱AI的图像生成模型CogView。
前提条件
你需要通过ZhiPuAI创建一个API，以访问ZhiPu AI语言模型。
在ZhiPu AI 注册页面创建账户，并在API密钥页面生成Tokens。
Spring AI项目定义了一个名为spring.ai.zhipuai.api-key的配置属性，您应将其设置为从API密钥页面获取的API Key值。
您可以在application.properties文件中设置此配置属性：
spring.ai.zhipuai.api-key=<your-zhipuai-api-key>为了在处理API密钥等敏感信息时增强安全性，您可以使用Spring表达式语言（SpEL）引用自定义环境变量：
# In application.yml
spring:
ai:
zhipuai:
api-key: ${ZHIPUAI_API_KEY}# In your environment or .env file
export ZHIPUAI_API_KEY=<your-zhipuai-api-key>您也可以在应用程序代码中以编程方式设置此配置：
// Retrieve API key from a secure source or environment variable
String apiKey = System.getenv("ZHIPUAI_API_KEY");自动配置
|
There has been a significant change in the Spring AI auto-configuration, starter modules' artifact names. Please refer to the 升级说明以获取更多信息。 |
Spring AI提供针对ZhiPuAI聊天客户端的自动生成配置。
要使它工作，将以下依赖项添加到项目Maven pom.xml文件中：
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-model-zhipuai</artifactId>
</dependency>或者添加到您的Gradle 构建脚本文件中。
dependencies {
implementation 'org.springframework.ai:spring-ai-starter-model-zhipuai'
}| 参考以下依赖管理部分，添加Spring AI BOM到你的构建文件中。 |
图像生成属性
|
图片自动配置的启用和禁用现在通过带有前缀 要启用，请设置 spring.ai.model.image=stabilityai （默认情况下已启用） 要禁用，请设置 spring.ai.model.image=none（或任何不匹配stabilityai的值）。 这种修改是为了允许配置多个模型。 |
前缀 spring.ai.zhipuai.image 是属性前缀，允许您为 ZhiPuAI 配置 ImageModel 实现。
属性 |
描述 |
默认 |
spring.ai.zhipuai.image.enabled（已移除，不再有效） |
启用ZhiPuAI图像模型。 |
true |
spring.ai.model.image |
启用ZhiPuAI图像模型。 |
智图AI |
spring.ai.zhipuai.image.base-url |
可选地，覆盖 `spring.ai.zhipuai.base-url` 以提供聊天特定的URL。 |
- |
spring.ai.zhipuai.image.api-key |
可选地，覆盖 `spring.ai.zhipuai.api-key` 以提供聊天特定的 api 密钥。 |
- |
spring.ai.zhipuai.image.options.model |
用于图像生成的模型。 |
cogview-3 |
spring.ai.zhipuai.image.options.user |
一个代表你的终端用户的唯一标识符，有助于ZhiPuAI进行监控和检测滥用行为。 |
- |
连接属性
The prefix spring.ai.zhipuai is used as the property prefix that lets you connect to ZhiPuAI.
属性 |
描述 |
默认 |
spring.ai.zhipuai.base-url |
要连接的URL |
|
spring.ai.zhipuai.api-key |
API 密钥 |
- |
重试属性
前缀 spring.ai.retry 用于作为属性前缀，允许您配置ZhiPuAI图像客户端的重试机制。
| 属性 | 描述 | 默认 |
|---|---|---|
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，且不重试客户端错误代码 |
false |
spring.ai.retry.exclude-on-http-codes |
不应触发重试的HTTP状态代码列表（例如，用于抛出非暂时性AI异常）。 |
empty |
spring.ai.retry.on-http-codes |
应触发重试的HTTP状态码列表（例如，用于抛出TransientAiException）。 |
empty |
运行时选项
ZhiPuAiImageOptions.java 提供了模型配置，如使用的模型、质量、大小等。
在启动时，默认选项可以通过 ZhiPuAiImageModel(ZhiPuAiImageApi zhiPuAiImageApi) 构造器和 withDefaultOptions(ZhiPuAiImageOptions defaultOptions) 方法进行配置。或者，使用之前描述的 spring.ai.zhipuai.image.options.* 属性。
在运行时，您可以通过向ImagePrompt调用添加新的、特定于请求的选项来覆盖默认选项。
例如，要覆盖与ZhiPuAI相关的特定选项，如质量及要创建的图片数量，请使用以下代码示例:
ImageResponse response = zhiPuAiImageModel.call(
new ImagePrompt("A light cream colored mini golden doodle",
ZhiPuAiImageOptions.builder()
.quality("hd")
.N(4)
.height(1024)
.width(1024).build())
);| 除了特定于模型的ZhiPuAiImageOptions之外，您还可以使用可移植的ImageOptions实例，通过ImageOptionsBuilder#builder()创建。 |