一、ZhiPuAI 图像生成
Spring AI 支持智谱 AI 的 CogView 图像生成模型。
二、先决条件
您需要创建一个智谱 AI 的 API 来访问智谱 AI 的语言模型。
在智谱 AI 注册页面 创建账户，并在 API 密钥页面 生成令牌。
Spring AI 项目定义了一个名为 spring.ai.zhipuai.api-key 的配置属性，您应将其设置为从 API 密钥页面获得的 API 密钥值。
您可以在 application.properties 文件中设置此配置属性：
spring.ai.zhipuai.api-key=<your-zhipuai-api-key>为了在处理像 API 密钥这样的敏感信息时增强安全性，您可以使用 Spring 表达式语言（SpEL）引用自定义环境变量：
# 在 application.yml 中spring:ai:zhipuai:api-key:${ZHIPUAI_API_KEY}# 在您的环境变量或 .env 文件中exportZHIPUAI_API_KEY=<your-zhipuai-api-key>您也可以在应用程序代码中以编程方式设置此配置：
// 从安全来源或环境变量中检索 API 密钥StringapiKey=System.getenv("ZHIPUAI_API_KEY");2.1 添加仓库和 BOM
Spring AI 的构件发布在 Maven Central 和 Spring Snapshot 仓库中。请参阅 构件仓库 部分，将这些仓库添加到您的构建系统中。
为便于依赖管理，Spring AI 提供了 BOM（物料清单），以确保在整个项目中使用统一版本的 Spring AI。请参阅 依赖管理 部分，将 Spring AI BOM 添加到您的构建系统中。
三、自动配置
Spring AI 的自动配置和启动器模块的构件名称发生了重大变化。更多信息请参阅升级说明。
Spring AI 为 ZhiPuAI 聊天客户端提供了 Spring Boot 自动配置。要启用它，请在项目的 Maven pom.xml 文件中添加以下依赖：
<dependency><groupId>org.springframework.ai</groupId><artifactId>spring-ai-starter-model-zhipuai</artifactId></dependency>或在您的 Gradle build.gradle 构建文件中添加：
dependencies{implementation'org.springframework.ai:spring-ai-starter-model-zhipuai'}请参阅 依赖管理 部分，将 Spring AI BOM 添加到您的构建文件中。
3.1 图像生成属性
现在通过前缀为 spring.ai.model.image 的顶级属性来配置图像自动配置的启用和禁用。
启用：spring.ai.model.image=zhipuai（默认已启用）
禁用：spring.ai.model.image=none（或任何与 zhipuai 不匹配的值）
此项更改是为了支持配置多个模型。
前缀 spring.ai.zhipuai.image 是用于配置智谱 AI 的 ImageModel 实现的属性前缀。
3.2 连接属性
前缀 spring.ai.zhipuai 用作属性前缀，用于连接到智谱 AI。
3.3 配置属性
重试属性
前缀 spring.ai.retry 用作属性前缀，用于配置 ZhiPuAI 图像客户端的重试机制。
四、运行时选项
ZhiPuAiImageOptions.java 提供模型配置，例如要使用的模型、质量、尺寸等。
在启动时，可以使用 ZhiPuAiImageModel(ZhiPuAiImageApi zhiPuAiImageApi) 构造函数和 withDefaultOptions(ZhiPuAiImageOptions defaultOptions) 方法来配置默认选项。或者，使用前面描述的 spring.ai.zhipuai.image.options.* 属性。
在运行时，您可以通过向 ImagePrompt 调用添加新的、特定于请求的选项来覆盖默认选项。例如，要覆盖智谱 AI 特定的选项，如质量和要创建的图像数量，请使用以下代码示例：
ImageResponseresponse=zhiPuAiImageModel.call(newImagePrompt("A light cream colored mini golden doodle",ZhiPuAiImageOptions.builder().quality("hd").N(4).height(1024).width(1024).build()));除了特定于模型的 ZhiPuAiImageOptions，您还可以使用可移植的 ImageOptions 实例，该实例通过 ImageOptionsBuilder#builder() 创建。
