千问AI API密钥怎么配置？

配置API密钥是调用千问AI模型的第一步，也是经常容易出问题的一步。如果密钥不对，所有请求都会返回401错误，模型服务根本没法用。所以，正确的姿势是把密钥安全地填进去——下面从申请到不同环境下的配置，一步步说清楚。

在阿里云百炼平台申请API密钥

第一步：访问阿里云百炼控制台，用主账号登录（子账号默认没有创建密钥的权限）。

第二步：左侧导航栏点击「API密钥管理」→「创建新的API密钥」。

第三步：勾选《API密钥使用协议》，点击「确定」生成密钥对。页面会立即显示AccessKey ID和AccessKey Secret——

第四步：完整复制AccessKey Secret值（含sk-前缀），粘贴保存到安全位置。不要截图、不要发群、不要存明文文本文件。

在Python项目中配置密钥（推荐环境变量方式）

方法一：使用 .env.local 文件（最安全）
在项目根目录新建文件 .env.local，写入：
OPENAI_API_KEY=sk-你的实际密钥
OPENAI_API_BASE=https://dashscope.aliyuncs.com/compatible-mode/v1
然后确保该文件已加入 .gitignore，绝不能提交到代码仓库。

方法二：直接写入代码（仅限本地快速测试）
在调用千问API的Python脚本开头，添加：
import os
os.environ["OPENAI_API_KEY"] = "sk-你的实际密钥"
⚠️注意：这行代码必须放在导入openai或dashscope库之前执行。

在Spring Boot项目中配置密钥

打开 application.yml 文件，在 spring.cloud.ai.tongyi.chat.options 下添加 api-key：

spring:
cloud:
ai:
tongyi:
chat:
options:
api-key: sk-你的实际密钥

若使用 application.properties，则写成：
spring.cloud.ai.tongyi.chat.options.api-key=sk-你的实际密钥

Spring Boot 3.3.x+ 版本才能识别该配置路径，低版本需改用 dashscope 相关配置项。

在VS Code插件中填写密钥

按下 Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）打开设置 → 搜索框输入 tongyi lingma.apiKey → 点击右侧铅笔图标 → 粘贴完整的 AccessKey Secret（不含空格、换行、引号）。

这一步填错会导致补全功能完全不触发，而且插件不会报错提示，只会静默失效——调试起来相当头疼。