8. 成员使用模型
完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。
成员在能力中心查找已获授权的模型，获取 API 密钥并接入业务应用或开发工具。能力中心的页签、「首页」左侧导航和右上角账号菜单见 1.2 节。
本章功能属于基础功能许可。成员能看到和调用的模型，取决于管理员为模型服务配置的可用范围（第 7 章）。
8.1 浏览模型广场
入口：「能力中心 → 模型广场」。
- 用顶部搜索框（「搜索模型」，快捷键 ⌘K）按名称搜索；
- 左侧按「最新上架」「最多使用」排序，按「分类」和「模型厂商」筛选。分类由管理员在「分类管理」中维护（第 5.5 节）；
- 模型卡片显示模型名、分类标签、描述、上下文长度和最大输出长度。
未登录时也可浏览公开目录；登录后，列表按当前账号可使用的模型服务过滤。
点击卡片进入模型详情。页头显示服务提供方、上下文、模态、用户计费价和上架时间，可「复制模型 ID」。详情分为以下区域：
| 区域 | 内容 |
|---|---|
| 「概览」 | 模型说明 |
| 「首次调用 API」 | Base URL、代码示例、客户端环境变量（第 8.3 节） |
| 「计费」 | 当前输入、输出、缓存读取、缓存写入计费价（每百万 tokens）和价格历史；官方参考价仅供参考，不代表本平台扣费，实际扣费以账单为准 |
| 「运行表现」 | 吞吐、延迟、首字延迟（TTFT）、缓存命中率、工具调用错误率、结构化输出错误率，可选平均值、P50、P95 和近 3 天、近 14 天；「请求成功率」按小时显示近 3 天时间线 |
| 「能力评测」 | 第三方评测得分 |
| 「调用用量」 | 近 14 日的输入、输出、推理 token 用量及调用来源 |
8.2 在线试用
在模型详情页头选择「在 Playground 中打开」，可直接与对话模型进行对话试用，不需要自己的 API 密钥。
前提：已登录；账号有可用的计费归属，且对应模型服务已启用并包含该模型。未登录时点击会先跳转登录。试用产生真实调用和费用，在用量中记为“试跑”。不满足条件时，页面显示具体原因，例如“该服务没有可用的对话模型”。
8.3 获取 API 密钥并发起首次调用
每把 API 密钥只绑定一个模型服务，可调用该服务下全部已启用模型。成员可通过两个入口创建 Key。
从模型详情创建：
- 在模型详情页头选择「获取 API 密钥」，打开「获取 API 密钥」对话框。
- 选择「API 密钥归属」。选项为管理员分发给该成员的归属，例如公共、部门、职能组或个人专属；只有一个可用归属时自动选中。
- 可选：在「指定 API 密钥（可选）」中填写已有的 Key 字符串，用于导入已有 Key。留空则自动生成。导入的 Key 须为 32～512 位，仅含字母、数字和
-._~+/=。 - 选择「创建」。从此入口创建的 Key 有效期为 90 天，名称自动生成。
- 新 Key 出现在对话框下方的「API 密钥列表」中，可显示、隐藏或复制。
从首页创建：
- 进入「能力中心 → 首页 → API 密钥」，选择「创建 key」。
- 填写「名称」，选择「模型服务」和计费归属。选定归属后，对话框提示这把 Key 的用量计入哪些额度池。
- 可选：填写「指定 API 密钥（可选）」导入已有 Key，规则同上。
- 选择「确认」。结果页显示「API 密钥（仅本次可见）」，立即复制并保存到业务系统的密钥管理中。从此入口创建的 Key 不设到期时间。
租户在安全设置中关闭 Token 访问时，无法签发模型 API 密钥，页面提示联系管理员开启。
发起首次调用：模型详情的「首次调用 API」区域提供四种协议的示例：OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Gemini generateContent，每种都有 TypeScript、Python 和 cURL 三种写法。示例中的 Base URL 由平台按网关访问地址生成；本次会话中刚创建过 Key 时，复制的示例会带上该 Key，否则为占位符 YOUR_API_KEY。
每种协议下方给出对应开发工具的环境变量：
| 协议 | 工具 | 环境变量 |
|---|---|---|
| OpenAI Chat Completions | OpenAI SDK | OPENAI_BASE_URL、OPENAI_API_KEY |
| OpenAI Responses | Codex | OPENAI_BASE_URL、OPENAI_API_KEY，另附 ~/.codex/config.toml 配置 |
| Anthropic Messages | Claude Code | ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY |
| Gemini generateContent | Gemini CLI | GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY |
区域中还有：
- 「会话归属（可选）」：同一对话的请求携带相同的会话请求头，可指定会话归属；不携带时由网关自动识别；
- 「列出可用模型」：一条
GET /models请求列出该 Key 所属服务下全部已启用模型。
各协议的 Base URL、鉴权头和接口清单见第 10 章「调用接口」。
8.4 管理本人的 API 密钥
入口：「能力中心 → 首页 → API 密钥」。
列表列为「名称」「Key」（前缀加掩码，可复制）、「最后使用」「状态」「创建时间」和操作。状态包括“正常”“已停用”“已过期”“已撤销”。
不再使用或怀疑泄露的 Key，选择「撤销」并确认，使用该 Key 的调用立即失效。成员不能在此轮换 Key；需要保留调用连续性的轮换，请联系管理员在「API 密钥管理」中执行（第 6.7 节），或新建 Key 切换后撤销旧 Key。
同一页面下方的「访问密钥」用于签名调用平台管理接口，与模型调用无关。
8.5 查看本人用量与调用日志
入口：「能力中心 → 首页」，左侧导航「用量」分组下的「使用情况」「模型用量」「调用日志」。各分区的内容、筛选项与统计口径见第 17.1 节。
调用日志中的 Request ID 与网关响应头 x-request-id 一致，向管理员反馈问题时附上该值。