跳转到主要内容
管理

API Key

创建和管理 API Key

概述

每个发送到千问AI平台的 API 请求都需要使用 API Key 进行身份验证。API Keys 页面集中管理您的所有访问凭证,包括按量付费 API Key 和 Token Plan API Key。
  • 按量付费 API Key:用于按量付费模型调用,属于一个业务空间,继承该业务空间的模型访问权限和限流。
  • Token Plan API Key:用于调用订阅套餐支持的模型,消耗套餐 Credits。个人版和团队版的凭证分别展示在对应页签中。
如需快速获取第一个 API Key 的指南,请参阅获取 API Key。

选择 API Key 与服务端点

根据本次调用的计费方式选择 API Key,并使用对应的服务端点(Base URL 或 HTTP 请求地址)。购买 Token Plan 后,使用按量付费 API Key 和按量付费接口的调用仍按量计费,不会自动抵扣套餐 Credits。
调用方式获取位置与密钥格式服务端点与计费
按量付费API Keys 页面的按量付费区域,sk-ws- 开头(早期密钥为 sk-)使用模型 API 文档中的按量付费接口,按模型调用量计费
Token PlanAPI Keys 页面的 Token Plan 区域,在个人版或团队版页签复制 sk-sp- 开头的密钥使用 Token Plan 对应能力的专用接口,消耗对应套餐的 Credits
调用前,请核对具体模型 ID 是否在个人版支持的模型或团队版支持的模型列表中。套餐支持范围以对应列表为准。 API Key 与服务端点必须配套使用,不可混用。文本对话的端点配置见个人版快速开始和团队版快速开始;图像、视频、语音等能力使用各自的接口,见多模态接入概览。例如,wan3.0-video 的套餐接口见Token Plan 视频生成接入指南。

创建 API Key

以下步骤用于创建按量付费 API Key。已有 Token Plan 订阅的用户,请在 API Keys 页面的 Token Plan 区域复制对应套餐的专属密钥。
1

选择业务空间

前往 API Key 页面。如需切换业务空间,点击侧边栏底部的业务空间按钮,在弹出面板中选择目标业务空间。
2

创建 API Key

点击创建 API Key。输入描述信息以便后续识别(例如"主应用的生产环境 API Key"),然后点击生成 API Key。
3

复制 API Key

请立即复制 API Key——密钥仅显示一次。关闭对话框后,您只能看到密钥的掩码版本。
每个业务空间最多支持 20 个 API Key。当前数量显示在创建 API Key 按钮上(例如 0/20)。

管理按量付费 API Key

在 API Keys 页面的按量付费区域,您可以:
  • 搜索:通过描述内容查找 API Key。
  • 编辑:点击编辑以更新 API Key 的描述信息。
  • 删除:点击删除以永久撤销 API Key。此操作不可撤消——使用该 API Key 的所有请求将立即失败。
  • 启用/禁用:通过状态开关启用或禁用 API Key。禁用后,使用该 Key 的请求将被拒绝;重新启用后立即恢复。
  • 查看费用:点击查看费用跳转至该 API Key 的费用明细页面。
API Key 表格显示每个密钥的 ID、API Key(已掩码)、描述、创建时间、费用、状态以及可用的操作。

管理 Token Plan API Key

在 API Keys 页面的 Token Plan 区域,展示您的 Token Plan 访问凭证和接口地址(OpenAI 兼容、Anthropic 兼容)。通过个人版和团队版标签页切换查看对应的 API Key,表格包含 API Key(已掩码)、API Key 状态、套餐名称、剩余天数和操作(重置、套餐管理)。
  • 重置:重新生成 API Key,原 Key 立即失效。
  • 套餐管理:跳转至对应的 Token Plan 管理页面,查看订阅详情和用量。团队版的席位分配和成员管理需在 Token Plan 管理页面点击席位分配&查看用量进入管理平台操作。
Token Plan API Key 的完整管理(席位分配、SSO 登录、成员管理)请在管理平台中操作:在 Token Plan 管理页面点击席位分配&查看用量进入。详见团队管理。

按量付费 API Key 与业务空间

按量付费 API Key 的作用范围限定在其创建时所在的业务空间:
  • 默认业务空间中的 API Key 可以调用所有可用模型,使用账户级别的速率限制。
  • 子业务空间中的 API Key 只能调用已授权给该业务空间的模型,使用为该业务空间配置的速率限制。
要管理其他业务空间的 API Key,请点击侧边栏底部的业务空间按钮切换到目标业务空间。

安全最佳实践

  • 安全存储密钥:使用环境变量或密钥管理器。切勿将 API Key 硬编码在源代码中。
  • 不要在客户端暴露密钥:API Key 只应在服务端代码中使用。切勿将其包含在前端应用、移动应用或浏览器代码中。
  • 定期轮换密钥:删除已泄露或未使用的 API Key,并创建新密钥。
  • 为不同环境使用独立密钥:为开发、测试和生产环境创建不同的 API Key(或业务空间)。