必须完成密钥配置、依赖引入、模型选择和请求构造四个核心环节；需安全配置API Key为环境变量，引入dashscope-sdk-java依赖，初始化客户端并显式设置apiKey，推荐新手选用qwen-plus模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Java项目中调用千问AI API实现文本生成、对话等能力，必须先完成密钥配置、依赖引入、模型选择和请求构造四个核心环节，缺一不可。
获取并安全配置API Key
登录阿里云百炼控制台（https://www.php.cn/link/07cb5b5337dc005c70dc51527a70162a），用支付宝或淘宝账号实名认证后，在「API-KEY管理」页面创建一个新Key，复制完整字符串（格式为sk-xxxxxxxxxxxxxxxxxxxxxxxx）。
不要把Key硬编码进Java文件或提交到Git仓库，否则可能被他人盗用导致额度耗尽甚至产生费用。最稳妥的做法是设为系统环境变量：Linux/macOS下执行export DASHSCOPE_API_KEY=sk-xxxxx，Windows CMD中执行set DASHSCOPE_API_KEY=sk-xxxxx。
Spring Boot项目可在application.yml中配置：
ai:<br> dashscope:<br> api-key: ${DASHSCOPE_API_KEY}
立即学习“Java免费学习笔记（深入）”；
引入官方SDK依赖（推荐方式）
打开pom.xml，添加DashScope官方Java SDK：
<dependency><br> <groupId>com.alibaba</groupId><br> <artifactId>dashscope-sdk-java</artifactId><br> <version>2.14.0</version><br></dependency>
该SDK已封装HTTP调用、签名、重试、流式响应等细节，比手写HttpClient更健壮。若使用Gradle，则写：implementation 'com.alibaba:dashscope-sdk-java:2.14.0'。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
编写基础调用代码
第一步：初始化Generation客户端
第二步：构建QwenParam参数对象，指定模型（如qwen-plus）、消息列表（system+user角色）、输出格式
第三步：调用gen.call(param)发起同步请求
第四步：从result.getOutput().getChoices().get(0).getMessage().getContent()提取返回文本
注意：【必须显式设置Constants.apiKey = apiKey】，否则SDK会抛出NoApiKeyException异常——这是新手最容易卡住的一步。
Spring AI集成（零侵入式）
方法一：使用Spring AI Starter
添加依赖：spring-ai-alibaba-starter（版本1.0.0-M6），配置spring.ai.dashscope.api-key，然后注入ChatClient直接调用prompt().user("你好").call().content()。
方法二：使用Spring Cloud Alibaba AI模块
需引入spring-cloud-starter-alibaba-ai，配置路径为spring.cloud.ai.tongyi.chat.options.api-key，再通过@Autowired ChatClient完成调用。
两种方式都无需处理HTTP细节，且支持无缝切换OpenAI、文心一言等其他模型服务商。
选对模型才能控成本
① 简单问答、学习辅助 → 优先用qwen-turbo（免费/¥0.3每百万Token输入）
② 通用对话、RAG检索增强 → qwen-plus是性价比首选（¥0.8输入 + ¥2输出）
③ 复杂逻辑推理、多步决策 → 上qwen-max，但单次调用成本可能达¥80+
④ 处理万字长文 → 必须选qwen-long，否则会因上下文截断导致语义断裂
新手起步一律从qwen-plus开始，能力足够、价格适中、响应稳定。
