1. 核心前提

• 账号要求：必须使用主账号或拥有管理员权限的子账号。
• 操作入口：前往对应地域（北京/新加坡/弗吉尼亚）的“API Key”页面点击创建。（本人默认是北京）

点击最中间的创建

2. 创建时的关键选择

在创建弹窗中，需配置两项核心信息：

• 归属账号：
  • 默认/推荐：选主账号（适合个人或不涉及人员变动的场景）。
  • 团队协作：选特定子账号。若该子账号被移除，Key自动失效，便于权限管理。
• 归属业务空间：
  • 默认：选默认空间（可调用所有标准模型）。
  • 隔离/分账：选子业务空间。用于隔离项目资源、控制模型访问权限或进行成本分账。

注意：如果是用 Coding Plan，请使用专属 Key (sk-sp-xxxxx)，不要用通用的 (sk-xxxxx)。

3. 如何使用 API Key

调用模型时通常需要三个信息：

1. API Key：即刚才创建的凭证。
2. Base URL（根据地域选择）：
   • 北京：https://dashscope.aliyuncs.com/compatible-mode/v1
   • 新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
   • 美国：https://dashscope-us.aliyuncs.com/compatible-mode/v1
3. 模型名称：例如 qwen-plus。

• 工具调用：直接填入上述三项到 Chatbox、Dify、Postman 等工具。
• 代码调用：强烈建议将 Key 放入环境变量，严禁硬编码在代码中以防泄露。

4. 权限与有效期规则

• 权限范围：Key 的权限完全由业务空间决定。同一空间内的 Key 权限相同，无需为不同模型（文生文、文生图等）分别创建 Key。
  • 默认空间 Key = 调用所有标准模型 + 默认空间应用。
  • 子空间 Key = 仅调用该子空间授权的模型 + 该空间应用。
• 有效期：
  • 永久有效：除非手动删除或关联的 RAM 用户被删除/禁用。
  • 临时 Key：支持生成有效期仅 60秒 的临时 Key，用于高风险或第三方临时访问场景，降低泄露风险。

5. 常见限制 (FAQ)

• 数量限制：每个主账号最多 20个 业务空间，每个空间最多 20个 API Key。
• 人员离职处理：若 RAM 用户（子账号）被删除或禁用，其名下创建的所有 API Key 立即失效。

---

一句话总结：用主账号去对应地域页面创建 Key，根据团队需求选择归属人和业务空间，拿到 Key、URL 和模型名即可调用，务必注意保管密钥安全。