OpenAI

OpenAI Image Generation

Spring AI 支持 OpenAI 的 DALL-E 图像生成模型。

先决条件

您需要使用 OpenAI 创建 API密钥 来访问 ChatGPT 模型。

在OpenAI 注册页面 创建帐户 并在API 密钥页面生成令牌。 Spring AI 项目定义了一个名为的配置属性，您应该将其设置为从 openai.com 获取的spring.ai.openai.api-key值。

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

export SPRING_AI_OPENAI_API_KEY=<INSERT KEY HERE>

自动配置

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

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

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

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

配置属性

图像生成属性

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

连接属性

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

重试属性

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

运行时选项

OpenAiImageOptions.java 提供模型配置，例如：使用的模型、质量、大小等。

在启动时，可以使用 OpenAiImageClient(OpenAiImageApi openAiImageApi) 构造函数 和 withDefaultOptions(OpenAiImageOptions defaultOptions) 方法配置默认选项。或者，使用 spring.ai.openai.image.options.* 前面描述的属性。

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

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

);

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