Spring AI 接入 QuickRouter 并发出首个请求

更新于

在 Spring AI 1.1 项目添加 OpenAI SDK Starter,从命令行验证 ChatClient。

先创建 QuickRouter 令牌。如果需要换模型,从模型目录复制完整 ID,并确认令牌支持对应接口。

添加 OpenAI SDK Starter;配置模型与连接;运行 ChatClient
操作路径示意。

1. 添加 OpenAI SDK Starter

在已导入 Spring AI 1.1 BOM 的 Spring Boot 项目中加入下面的依赖。

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

2. 配置模型与连接

将下面的配置合并到 application.properties,并在启动项目的环境设置 QUICKROUTER_API_KEY。

spring.ai.openai-sdk.base-url=https://api.quickrouter.ai/v1
spring.ai.openai-sdk.api-key=${QUICKROUTER_API_KEY}
spring.ai.openai-sdk.chat.options.model=gpt-4o-mini

3. 运行 ChatClient

把配置类放在 Spring Boot 主类扫描的包下,并补上项目自己的 package 声明。运行 ./mvnw spring-boot:run,检查控制台输出与QuickRouter 使用日志。

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
class QuickRouterDemo {
    @Bean
    CommandLineRunner tryQuickRouter(ChatClient.Builder builder) {
        return args -> {
            String text = builder.build().prompt()
                .user("请只回复 OK。")
                .call()
                .content();
            System.out.println(text);
        };
    }
}

常见问题

  • 配置没有生效。确认引入的是 1.1 的 OpenAI SDK Starter,再检查 spring.ai.openai-sdk 前缀。
  • 404。该 Starter 的 Base URL 填到 /v1,并确认模型支持 Chat Completions。

相关文档

在线客服