1. 核心前提
- 账号要求：必须使用主账号或拥有管理员权限的子账号。
- 操作入口：前往对应地域（北京/新加坡/弗吉尼亚）的“API Key”页面点击创建。（本人默认是北京）
点击最中间的创建
2. 创建时的关键选择
在创建弹窗中，需配置两项核心信息：
- 归属账号：
- 默认/推荐：选主账号（适合个人或不涉及人员变动的场景）。
- 团队协作：选特定子账号。若该子账号被移除，Key自动失效，便于权限管理。
- 归属业务空间：
- 默认：选默认空间（可调用所有标准模型）。
- 隔离/分账：选子业务空间。用于隔离项目资源、控制模型访问权限或进行成本分账。
注意：如果是用 Coding Plan，请使用专属 Key (
sk-sp-xxxxx)，不要用通用的 (sk-xxxxx)。
3. 如何使用 API Key
调用模型时通常需要三个信息：
- API Key：即刚才创建的凭证。
- 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
- 北京：
- 模型名称：例如
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 和模型名即可调用，务必注意保管密钥安全。
