19. 成员使用模型

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

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

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

成员能调用哪些模型，取决于管理员把哪些模型分组分发给了本人（直接分发，或经所在部门、职能组、工作空间分发）；可用范围与配额的配置见第 7 章。各调用协议的路径、请求头与错误码见第 21 章；密钥的轮换、禁用与调用方身份见第 20 章。

19.1 模型相关入口

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

「首页」左侧分为「用量」「模型与凭据」「我的」「个人设置」四组。与模型使用相关的入口如下：

注意：用量、调用记录和 API 密钥都按当前工作空间统计。核对数字前先确认左上角的工作空间，跨工作空间的用量不会合并显示。

19.2 在模型广场查找模型

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

操作步骤

1. 点击顶栏「模型」进入模型广场。页面上方显示「全部」以及当前列出的模型数量。
2. 在左侧按需筛选：「热门推荐」（「最新上架」「最多使用」）、「分类」（由管理员维护）、「模型厂商」。
3. 在「搜索模型」框中输入关键词。关键词按空格分词，直接输入 deepseek v4.1 flash 即可命中「DeepSeek V4.1 Flash」；搜索可与分类、厂商筛选叠加。
4. 点击模型卡片进入模型详情。

你会看到

• 广场列出平台的模型目录。已分发给本人的模型可直接查看与调用；尚未分发的卡片底部标注「需要管理员分发」，进入详情后「获取 API 密钥」的「API 密钥归属」里也不会出现包含该模型的分组。
• 同一个模型可能出现在多张卡片上（不同服务提供方或接入方式各占一张），厂商与提供方标注不同，单价也可能不同。

模型详情

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

注意

• 「用户计费价」会先显示「加载中…」，取回后才出现实际单价。
• 「官方参考价」是供应商公示价的参考值，实际扣费以「用户计费价」为准。
• 「能力评测」未接入评测数据时显示「暂无此分区数据」，不影响调用。

19.3 在线试用模型

适用场景：正式接入前，先在试验台与对话模型聊几轮，确认回答质量、上下文表现和响应速度。

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

操作步骤

1. 在模型详情页头点击「在试验台中打开」。对话框顶部显示当前模型名和「参数」。
2. 需要调整生成参数时点击「参数」。
3. 在输入框中输入问题并发送，回答结束后可继续追问。

你会看到

• 回答按流式逐段出现；试验台保留当前对话的上下文。
• 试用产生真实调用和费用，计入本人用量，可在「调用日志」中查到。

注意

• 试验台使用平台侧的计费归属发起调用，不消耗您自己的 API 密钥。提示某个额度池已用尽时，可以改用 API 密钥调用同一模型，或请管理员补充额度。
• 比较不同模型时，先用「参数」把温度和最大输出长度固定下来，否则结论不可比。

19.4 获取 API 密钥

适用场景：业务系统、脚本或开发工具（如 Claude Code、Codex）需要以程序方式调用模型。

前提：管理员已把至少一个模型分组分发给本人。

操作步骤（从模型详情获取）

1. 在模型详情页头点击「获取 API 密钥」。
2. 在「API 密钥归属」中选择用量计入哪个归属。只有一个可选时自动选中。
3. 需要沿用业务系统已在使用的密钥字符串时，在「指定 API 密钥（可选）」中填入；留空由平台自动生成。
4. 在「挂到哪个客户端」中选择「选择已有客户端」，或「新建客户端」并填写名称、选择类型。
5. 点击「创建」。页面提示「API 密钥已创建」，新密钥出现在下方「API 密钥列表」中。

你会看到

• 「API 密钥列表」新增一行，显示掩码前缀（如 lp_60c50ae…）与状态「正常」。
• 选择「新建客户端」时，对话框下方给出「新客户端的观测上报配置」，是一组环境变量，其中的上报密钥只显示这一次。把它加到该客户端的启动环境中，「洞察」里就能看到它的会话轨迹。

注意

• 归属在创建后不能更改。要换归属，新建一把密钥再切换业务。
• 下拉里没有某个模型分组，说明它没有分发给本人，请联系管理员。
• 密钥明文复制后立即保存到业务系统的密钥管理或环境变量中，不要写进代码仓库、聊天记录或工单。
• 租户为密钥申请配置了审批时，提交后提示「已提交审批」，批准后才能使用。租户关闭了令牌访问时，页面提示无法签发，请联系管理员。

19.4.1 复制接入配置

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

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

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

结果确认：用示例代码发起一次调用，返回 200 和模型回答即接入成功。密钥创建后立即可用。

19.4.2 在「API keys」中管理本人的密钥

适用场景：集中查看本人在当前工作空间创建的全部密钥，或不经模型详情直接按模型分组创建密钥。

操作步骤

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

你会看到

• 状态可能为「正常」「待审批」「已驳回」「已撤回」「已停用」「已过期」「已撤销」。待审批的密钥显示「批准后可查看」，可选择「撤回申请」；被驳回后可「重新申请」。
• 撤销后使用该密钥的调用立即失效。

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

19.5 在对话和智能体中使用模型

适用场景：在对话页与智能体交流，或创建自己的智能体时，选择由哪个模型回答。

前提：管理员已把包含所需模型的模型分组分发给本人或本人所在的工作空间。

操作步骤

1. 创建智能体时，在「身份与模型」一步的「模型」中选择一个可用的模型；标注「（全局默认）」的为租户默认的对话模型。已创建的智能体在详情「智能体」页签点击「更换模型」。
2. 在对话输入区点击「模型」，从本人可用的模型中搜索并选择；选择「自动选择」时由平台按任务选用合适的模型。

你会看到

• 下拉中显示「暂无可用的模型，请联系管理员分发」时，说明当前工作空间没有分发给本人的模型分组。
• 所选模型暂时繁忙或不可用时，对话中提示已切换到备用模型或备用通道，本次回答在速度或细节上可能略有差异。
• 智能体保存的模型不可用时，提示「已保存的模型不可用」并给出推荐替代，编辑者确认后才会切换；没有编辑权限的成员会被提示联系智能体编辑者或管理员。

注意

• 智能体发起的模型调用使用智能体选择的模型，用量按分组顺序计入本人可用的模型分组，在调用记录中「发起方类型」显示为「智能体」（见 20.9）。
• 更换模型后，智能体后续运行使用新的模型。

19.6 可用范围对成员的影响

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

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

你会看到

注意

• 授权变更需要一点时间在各网关节点生效，通常在一分钟内。
• 确认自己应当有权限却看不到模型时，向管理员提供模型名和所属模型分组名，便于核对授权对象与有效期。

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

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

19.7.1 模型分组与配额

进入「首页 › 模型与凭据 › 模型分组」，列表显示本人可用的模型分组、「可用模型」与「用量&配额」，状态为「正常」「已停用」或「已用尽」。展开一行可看到按模型的调用次数、输入与输出 Token、缓存命中与写入 Token 和费用。

注意：这里显示的是对您生效的最紧的那个额度池的用量，可能来自企业、部门、工作空间或模型分组，并非个人专属配额。

19.7.2 模型用量

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

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

19.7.3 调用日志

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

• 视图：「按调用」逐条列出；「按回答」按一次完整回答聚合，便于查看整条执行链路；
• 筛选：「时间范围」（最近 24 小时、最近 7 天、最近 30 天、自定义范围）、「调用类型」（模型、MCP）、「状态」「计费归属」，以及按模型或请求标识搜索；
• 右上角「导出记录」导出 CSV。

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

注意

• 调用日志中的请求标识与网关响应头 x-request-id 一致。向管理员反馈问题时附上该值，管理员可以直接定位到这一次调用。
• 列表、Token 与费用按页面显示的「查询时间」固定，刷新后统一更新。
• 同一场多轮对话在「按调用」视图里是多条记录，在「按回答」视图里合并为一条。

能力说明

---

上一章：18. 运行时安全与凭据 · 下一章：20. 调用方与 API 密钥