8. 成员使用模型

完整版章节。内容按 2026.10 主线代码与运行环境界面核对；具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容：本章面向使用模型的成员和业务开发人员，说明如何在工作台的模型广场找到自己可用的模型、了解它的价格与运行表现、在正式接入前在线试用、获取 API 密钥并复制接入配置，以及如何核对个人用量与逐次调用记录。

成员能调用哪些模型，取决于管理员把哪些模型分组分发给了本人（直接分发，或经所在部门、职能组分发）；授权、配额与限额的配置见第 7 章。各调用协议的路径、请求头与错误码见第 10 章；成员可以自行创建与撤销本人的密钥（见 8.4 节）；密钥的轮换、禁用、删除由管理员在管理后台执行，见第 9 章。

8.1 工作台与模型相关入口

成员登录后进入工作台。顶部一级导航为「首页」「模型」「MCP」「API」「知识库」「技能」「插件」「A2A」「洞察」「智能体」（实际显示的页签以租户许可和账号权限为准）；左上角显示当前工作区，可在下拉菜单中切换；右上角为全局搜索和账号菜单。

与模型使用相关的入口如下：

注意：用量与调用记录按当前工作区统计。核对数字前请先确认左上角的工作区是否需要切换，跨工作区的用量不会合并显示。

8.2 在模型广场查找模型

适用场景：接入前先确认某个模型是否可用、单价多少、最近跑得快不快，以及它支持哪些模态。

前提：已登录工作台。

操作步骤

1. 在左上角「搜索模型」框中输入关键词。关键词支持按空格分词，直接输入 deepseek v4.1 flash 即可命中「DeepSeek V4.1 Flash」，不必写成完整串；搜索可与分类、厂商筛选叠加使用。
2. 点击模型卡片进入模型详情。卡片上显示模型名、模态标签（如「多模态」）、简介，以及该模型是否已分发给本人。

你会看到

• 广场列出的是平台的模型目录。已分发给本人的模型可直接查看与调用；尚未分发的卡片底部标注「需要管理员分发」，进入详情后「获取 API 密钥」的「API 密钥归属」里也不会出现包含该模型的分组。
• 左侧筛选区的计数随筛选条件变化，「全部」后的数字表示当前视图中的模型总数，而不是平台的全部模型数。
• 同一个模型可能出现在多张卡片上（不同服务提供方或不同接入方式各占一张），卡片上的厂商与提供方标注不同，单价也可能不同。

模型详情

详情页头显示模型名、简介、「服务提供方」和可一键复制的模型名（调用接口时 model 字段填这个值），右上角为「在试验台中打开」和「获取 API 密钥」。左侧目录分为以下区域：

注意

• 打开详情页时，「用户计费价」会先显示「加载中…」，数据取回后才会出现实际单价；刷新页面会重新加载一次。
• 「官方参考价」是供应商公示价的参考值，实际扣费以本平台的「用户计费价」为准。
• 「能力评测」需要平台接入评测数据后才有内容，未接入时显示「暂无此分区数据」，不影响模型调用。

8.3 在线试用模型

适用场景：正式接入前，先在试验台里与对话模型对话几轮，确认回答质量、上下文表现和响应速度符合业务预期，避免写完代码才发现模型不合适。

前提：已登录；本人有可用的计费归属，且对应模型分组已发布并包含该模型。

操作步骤

1. 在模型详情页头点击「在试验台中打开」，弹出试验台对话框。对话框顶部显示当前模型名和「参数」。
2. 如需调整生成参数，点击模型名旁的「参数」，调整后关闭设置区。
3. 在输入框中输入问题（例如「用一句话说明什么是 AI 网关。」），点击发送。
4. 回答结束后可继续追问，试验台会保留本轮的上下文。

你会看到

• 回答按流式逐段出现，不会等整段生成完才显示。
• 对话框顶部的模型名为当前模型；同一模型的试验台固定在模型详情里打开，不会自动切换到其他模型。
• 试用产生真实调用和费用，计入本人的用量，可在「调用日志」中逐次查到（见 8.6.2）。

注意

• 试验台用的是平台侧的计费归属发起的调用，不消耗你自己的 API 密钥。
• 若发送后提示某个额度池已用尽，说明试验台所用归属的额度不足。此时可以改用 API 密钥直接调用同一模型（见 8.4），或请管理员为该归属补充额度；这不代表模型本身不可用。
• 模型对参数敏感时，先用「参数」把温度和最大输出长度固定下来再比较不同模型的表现，否则结论不可比。

8.4 获取 API 密钥

适用场景：业务系统、脚本或开发工具需要以程序方式调用模型时，用 API 密钥证明调用方身份。

前提：管理员已把至少一个模型分组分发给本人，因此「API 密钥归属」至少有一个可选项。

操作步骤

1. 点击「创建」。页面提示「API 密钥已创建」，新密钥出现在对话框下方的「API 密钥列表」中。

你会看到

• 创建后「API 密钥列表」新增一行，显示掩码形式的前缀（如 lp_60c50ae…）与状态「正常」，行尾提供查看与复制入口。
• 选择「新建客户端」时，创建完成后对话框下方给出一段「新客户端的观测上报配置」，是一组环境变量（开启遥测开关、上报接入点、上报凭据），其中的上报密钥标注「只显示这一次」。把这段配置粘贴到该客户端的启动环境里，「洞察」中就能看到它的会话轨迹。
• 同一个归属下可以创建多把密钥，用于区分不同的业务系统。

注意

• 归属决定这把密钥能调用哪些模型、占用哪个额度池，创建后不能更改。要换归属，请新建一把密钥再切换业务。
• 归属候选里只出现管理员分发给本人的对象。下拉里没有某个模型分组，说明它没有分发给本人，请联系管理员。
• 密钥明文请复制后立即保存到业务系统的密钥管理或环境变量中，不要写进代码仓库、聊天记录或工单。明文一旦外泄，应立即在「API keys」中撤销该密钥，或请管理员禁用。
• 「挂到哪个客户端」只影响统计与会话归属，不影响密钥能否调用；暂时不确定时可以先不挂，事后重建。
• 租户若为密钥申请配置了审批，提交后提示「已提交审批」，审批通过后才能使用。

在「API keys」中管理本人的密钥：进入「首页 › 模型与凭据 › API keys」，可集中查看本人创建的全部密钥，也可不经模型详情直接创建密钥。

1. 列表显示「名称」「密钥」（掩码，可点击复制）、「最后使用」「状态」「创建时间」。
2. 新建：点击「创建密钥」，填写「名称」，选择「模型分组」与「API 密钥计费归属」，可选填「指定 API 密钥（可选）」，点击「确认」。对话框显示「API 密钥（仅本次可见）」及「此密钥可调用该分组下全部已启用模型。」
3. 不再使用的密钥，在行操作中选择「撤销」，确认框提示「撤销后使用该密钥的调用将立即失效」。

成员不能在工作台轮换密钥。需要换新时，先创建新密钥完成切换验证，再撤销旧密钥；不中断业务的轮换由管理员执行（见 9.5 节）。

8.4.1 复制接入配置

模型详情的「首次调用 API」按协议分为「OpenAI Chat Completions」「OpenAI Responses」「Anthropic Messages」「Gemini generateContent」「视觉理解」五个页签，每个页签提供 TypeScript、Python、cURL 三种写法，右上角「复制」可整段复制。示例中的 Base URL 已按当前环境生成，模型名已填好，只需把示例里的 YOUR_API_KEY 换成自己的密钥。

区域下方还提供两项辅助配置：

• 会话归属（可选）：同一场对话的请求携带相同的 x-zenova-conversation-id 请求头，可精确指定会话归属；不携带时由网关自动识别。
• 列出可用模型：一条 GET /models 请求，列出这把密钥所属模型分组下全部可调用的模型。

结果确认：用示例代码发起一次调用，返回 200 和模型回答即接入成功。密钥创建后立即可用，不需要等待。这次调用也会出现在「调用日志」里。

注意：示例代码依赖各厂商的官方 SDK，不需要改造请求格式；其他语言直接用对应厂商的官方 SDK，只改 Base URL 与密钥即可，完整示例见第 10 章。

8.5 可用范围对成员的影响

适用场景：某个模型在广场里看不到，或者自己的密钥忽然开始报错，需要确认是不是授权变了。

前提：可用范围由管理员在「管理后台 › 组织与权限 › 模型分组 › 分组详情 › 可用范围与配额」中配置，可授权给「所有用户」、部门、职能组或单个成员，并可设置有效期（见第 7 章）。

你会看到

注意

• 授权变更后需要一点时间在各网关节点生效，通常在一分钟内。刚被移除授权时仍可能有少量请求成功，属于生效延迟。
• 若确认自己应当有权限却看不到模型，请向管理员提供模型名和所属模型分组名，便于核对授权对象与有效期。

8.6 查看个人用量与调用日志

适用场景：核对本月花了多少、某次调用为什么慢或失败，或者把它用到的问题反馈给管理员。

前提：已登录；用量按当前工作区统计，请先确认左上角的工作区。

8.6.1 模型用量

进入「首页 › 用量 › 模型用量」，页面按调用时的 API 密钥、模型分组与计费归属统计本人消费：

• 顶部卡片：「可用模型分组」（当前已授权且可调用的分组数）、「可用 API 密钥」（状态正常的密钥数）；
• 筛选：「时间范围」「模型分组」「计费归属」「模型」「API 密钥」；
• 指标：「模型调用次数」及成功率、「总 Token」（输入 / 输出）、消费金额、平均单次成本；
• 图表：「消费趋势」、「计费归属」占比、「模型占比」；
• 右上角「导出明细」可导出当前筛选范围的记录。

你会看到：把时间范围切到「最近 7 天」，各指标随即按该区间重算；「计费归属」占比按个人、公共、试跑、部门等归属分别列出百分比，可用来判断花费主要落在哪个归属上；消费明细表支持按 API 密钥、模型分组、模型、计费归属进一步筛选。

8.6.2 调用日志

进入「首页 › 用量 › 调用日志」，逐次核对模型调用与 MCP 调用：

• 视图切换：「按调用」逐条列出每次调用；「按回答」按一次完整回答聚合，便于查看整条执行链路；
• 筛选：「时间范围」「调用类型」「状态」「计费归属」，以及按模型或请求标识搜索；
• 列表列：「时间」「事件类型」（模型 / MCP）、「目标」（模型名与计量分组）、「状态」「Token」（输入 / 输出）、「耗时」「错误码」，点击行查看详情；
• 右上角「导出记录」可导出当前筛选结果。

结果确认：刚完成的试用或接口调用会在日志中出现，状态、Token 与耗时与调用方实际收到的结果一致；被配额、限流或规则拦截的调用同样有记录，并计入成功率的统计。

注意

• 调用日志中的请求标识与网关响应头 x-request-id 一致。向管理员反馈问题时请附上该值，管理员可以直接定位到这一次调用。
• 「使用情况」页汇总近期使用概况与活跃情况，适合快速浏览；需要按维度核对金额时使用「模型用量」。
• 同一场多轮对话在「按调用」视图里是多条记录，在「按回答」视图里合并为一条。

能力说明

---

上一章：7. 配置模型分组的可用范围与配额 · 下一章：9. 调用方与 API 密钥