|
最新快照版本请使用Spring AI 1.1.0！ |
ZhiPuAI图像生成
Spring AI 支持 ZhiPuAI 的图像生成模型 CogView。
前提条件
你需要用 ZhiPuAI 创建一个 API 来访问 ZhiPu 的 AI 语言模型。
在ZhiPu AI注册页面创建账户，并在API密钥页面生成Tokens。
Spring AI 项目定义了一个配置属性，名为Spring.ai.zhipuai.api-key。你应该设置为API 密钥获取自 API 密钥页面。
你可以在你的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");自动配置
|
春季AI自动配置、起始模块的工件名称发生了重大变化。 更多信息请参阅升级说明。 |
Spring AI 为 ZhiPuAI 聊天客户端提供 Spring Boot 自动配置。
要启用它，请在项目的Maven中添加以下依赖pom.xml文件：
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-model-zhipuai</artifactId>
</dependency>或者去你的Gradlebuild.gradle构建文件。
dependencies {
implementation 'org.springframework.ai:spring-ai-starter-model-zhipuai'
}| 请参考依赖管理部分，将Spring AI的物料清单添加到你的构建文件中。 |
图像生成属性
|
启用和禁用图像自动配置现在通过顶层属性配置，前缀为 要启用，请 spring.ai.model.image=stabilityai（默认启用） 要禁用，可以选择 spring.ai.model.image=none（或任何与 stabilityai 不匹配的值） 此改动旨在允许配置多个模型。 |
前缀春.爱.志卜爱.image。是允许您配置图像模型ZiPuAI的实现。
属性 |
描述 |
默认值 |
spring.ai.zhipuai.image.enabled（已移除且不再有效） |
启用ZhiPuAI图像模型。 |
true |
spring.ai.model.image |
启用ZhiPuAI图像模型。 |
志卜爱 |
spring.ai.zhipuai.image.base-url |
可选覆盖 spring.ai.zhipuai.base-url，提供专门的聊天 URL |
- |
spring.ai.zhipuai.image.api-key |
可选覆盖 spring.ai.zhipuai.api-key，提供针对聊天的 api-key |
- |
spring.ai.zhipuai.image.options.model |
用于图像生成的模型。 |
认知-3 |
spring.ai.zhipuai.image.options.user |
一个代表终端用户的唯一标识符，有助于ZhiPuAI监控和检测滥用行为。 |
- |
连接性质
前缀spring.ai.zhipuai作为属性前缀，允许你连接到ZhiPuAI。
属性 |
描述 |
默认值 |
Spring.ai.zhipuai.base-url |
连接的URL（链接） |
|
Spring.ai.zhipuai.api-key。 |
API 密钥 |
- |
重试属性
前缀spring.ai.retry作为属性前缀，允许你配置ZhiPuAI图像客户端的重试机制。
| 属性 | 描述 | 默认值 |
|---|---|---|
spring.ai.retry.max尝试 |
重试次数上限。 |
10 |
spring.ai.retry.backoff.initial-interval |
指数式退避政策的初始睡眠时长。 |
两秒钟。 |
spring.ai.retry.backoff.multiplier |
后退间隔倍数。 |
5 |
spring.ai.retry.backoff.max区间 |
最大退回时间。 |
3分钟。 |
spring.ai.retry.on-client-errors |
如果为假，抛出非瞬态AiException，且不要尝试重试 |
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.*上述性质。
运行时，你可以通过添加新的、针对请求的选项来覆盖默认选项图片提示叫。
例如，要覆盖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（）创建的。 |