Spring AI 接入 QuickRouter 并发出首个请求
在 Spring AI 1.1 项目添加 OpenAI SDK Starter,从命令行验证 ChatClient。
先创建 QuickRouter 令牌。如果需要换模型,从模型目录复制完整 ID,并确认令牌支持对应接口。

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-mini3. 运行 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。