使用模型的第一步
选择调用方式
千问AI平台提供按量付费 API Key 和 Token Plan API Key。请先按调用方式选择密钥与服务端点,详见选择 API Key 与服务端点。获取按量付费 API Key 无需购买 Token Plan;已有套餐订阅也不会自动将按量付费接口的调用计入套餐。
创建 API Key
以下步骤用于创建按量付费 API Key。使用 Token Plan 时,请在 API Keys 页面的 Token Plan 区域复制对应个人版或团队版的专属密钥。
1
创建 API Key
前往 API Key 页面,点击创建 API Key。
2
添加描述
输入描述信息以便识别该 Key,然后点击生成 API Key。
3
复制 API Key
请立即复制并保存 API Key。出于安全考虑,完整的 Key 仅在创建时显示一次,之后列表中仅显示掩码版本。
使用 API Key
下方示例中的 Base URL 用于按量付费文本对话。Token Plan 和图像、视频、语音等能力的接口地址请参阅选择 API Key 与服务端点。
-
方式一:在第三方工具中使用(如 Chatbox)
在第三方工具中调用模型时,需要提供以下信息:
- API Key(按上述步骤创建后获取)
- Base URL:
https://maas.qianwenaiapi.com/compatible-mode/v1 - 模型名称(如
qwen3.7-plus、deepseek-v4-pro)
- 方式二:通过代码调用 将 API Key 设置为环境变量,避免在源代码中硬编码。
通过代码或第三方工具调用模型时,除 API Key 外还需指定服务端点(对应 SDK 或 HTTP 请求中的
base_url)。千问AI平台同时提供 OpenAI 兼容与 Anthropic 兼容两种协议的接口,两种协议的 base_url 不同,请以对应接口文档中的说明为准:- OpenAI 兼容协议:OpenAI 兼容-Chat
- Anthropic 兼容协议:Anthropic 兼容-Messages
管理 API Key
在 API Key 页面中,您可以:
- 搜索:通过描述信息查找 Key。
- 编辑:修改已有 Key 的描述信息。
- 删除:永久删除 Key。删除后无法恢复,使用该 Key 的应用将停止运行。
删除 API Key 后的异步任务
删除 API Key 后,该 API Key 无法使用,也无法找回。如果该 API Key 关联的异步任务还未执行或还未执行完毕,删除 API Key 后系统依然会正常执行这些任务。
如果确认不希望继续执行已关联的异步任务,请手动终止相关任务,避免在 API Key 删除后产生账单。
有效期
API Key 永久有效,除非您手动删除。
常见问题
按量付费 API Key 与 Token Plan API Key 的区别
按量付费 API Key(sk-ws- 开头,早期创建的 Key 为 sk-)配合按量付费接口使用,按模型调用量计费。Token Plan API Key(sk-sp- 开头)配合 Token Plan 专用接口使用,消耗对应订阅套餐的 Credits。Credits 用于统一计量套餐支持的文本、图像、视频、语音等模型及模型内置工具的调用,不仅计量文本 token 用量。两种密钥和接口不可混用,购买套餐不会自动抵扣按量付费接口产生的费用。
用 echo 命令确认环境变量设置成功了,为什么运行代码还是提示找不到 API Key?
具体原因如下:
- 情况一:没有设置永久性环境变量。临时环境变量只在当前终端会话有效,对于已经启动的 IDE 或其他应用程序并不会生效。请参考配置 API Key 到环境变量设置永久性环境变量。
- 情况二:没有重启 IDE、命令行工具或应用。通常需要重启 IDE(如 VS Code)或命令行工具,使其能够加载最新的环境变量。如果在部署应用后设置了环境变量,可能需要重启应用服务。
- 情况三:需要在配置文件添加环境变量。如果您的应用是通过服务管理器(如 systemd、supervisord)启动的,可能需要在服务管理器的配置文件中添加环境变量。
- 情况四:用了 sudo 命令。
sudo默认不继承所有环境变量。可采用sudo -E python xx.py命令,其中-E参数确保环境变量被传递。