通义千问API Key创建与配置完整指南

获取通义千问API的调用权限，第一步是生成并保管好你的API Key。这份凭证是访问所有模型接口的身份令牌，缺失或无效将导致所有请求被拒绝。以下流程将指导你完成从服务开通到密钥验证的每一步。

一、开通 DashScope 服务

生成API Key的前提，是激活阿里云平台上的DashScope（灵积）模型服务。作为通义千问系列模型的统一API入口，未开通此服务将无法进入密钥管理界面。

操作路径清晰：访问DashScope控制台首页，在“总览”页面找到“去开通”按钮。点击后，请审阅并勾选服务协议，随后即可完成开通。

二、创建并获取 API Key

服务开通后，系统通常会引导至API Key管理页面。若未自动跳转，可通过左侧导航栏手动进入。这里是创建专属访问凭证的核心区域。

关键操作：点击“创建新的API-KEY”。弹出的对话框内会显示新生成的密钥字符串。此时，必须立即点击“复制”按钮，并将其存入本地加密文档或专业的密码管理工具。保存完毕后，务必点击弹窗内的“我已保存”进行确认，此窗口关闭后密钥将不可再次查看。

三、通过阿里云百炼控制台创建（替代路径）

对于已开通阿里云百炼服务的用户，存在一条更便捷的路径。在百炼控制台生成的API Key，完全兼容通义千问的所有模型接口，无需重复开通DashScope服务。

具体步骤：登录百炼控制台，点击右上角头像图标，在下拉菜单中选择“API-Key管理”。后续的创建、复制与安全保存流程与上述步骤一致。

四、验证 API Key 可用性

获取密钥后，建议先进行最小化测试验证，以确保其有效性和权限正确，避免在后续集成中因密钥问题受阻。

推荐使用cURL发送一个简单的测试请求。在终端执行命令时，请将“YOUR_API_KEY”替换为你的真实密钥。验证成功的标志是：返回的JSON结果中包含状态码200及一个非空的“output”字段。

若返回“Invalid API key”或401错误，请检查：密钥字符串是否完整复制？是否误用了其他平台的AccessKey？排查无误后重新测试。