跳转到主要内容
开始使用

获取 API Key

使用模型的第一步

选择调用方式

千问AI平台提供按量付费 API Key 和 Token Plan API Key。请先按调用方式选择密钥与服务端点,详见选择 API Key 与服务端点。获取按量付费 API Key 无需购买 Token Plan;已有套餐订阅也不会自动将按量付费接口的调用计入套餐。
Token Plan 不覆盖平台所有模型,仅支持对应套餐模型列表中的模型。购买或调用前,请核对具体模型 ID 是否在个人版支持的模型或团队版支持的模型列表中。使用套餐额度时,必须使用 Token Plan 专属 API Key(sk-sp- 开头)和对应能力的专属接口地址。文本对话的地址见个人版快速开始或团队版快速开始;图像、视频、语音等能力的地址见多模态接入概览。使用按量付费密钥和接口的调用仍按量计费,不会抵扣套餐 Credits。

创建 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 不同,请以对应接口文档中的说明为准:
切勿泄露 API Key,未经授权的使用会带来安全风险和经济损失。

管理 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 参数确保环境变量被传递。