模型凭证

以 Markdown 格式查看

“模型凭证”用于把 OpenModels API 密钥连接到艾维斯。每个已保存的凭证会加密存储一把 API 密钥,同步这把密钥可访问的模型目录,并把这些模型提供给后续模型配置页面选择。

添加凭证不等于自动启用所有模型,也不会自动替换默认模型。目录同步完成后,请继续到语言模型以及图像、视频、语音等能力页面,选择实际要启用的模型。

准备事项

准备项说明
Admin 权限只有管理员应添加、轮换、刷新或删除模型凭证。
OpenModels API 密钥创建新凭证时必须填写。请先从 OpenModels 获取,再只粘贴到受保护表单中。
已批准的模型范围在设置默认模型前,先确认工作区允许使用哪些模型类型。
网络访问艾维斯部署环境需要能访问 OpenModels API。

获取 OpenModels API 密钥

如果组织已经有 OpenModels 账号,请向账号 owner 获取工作区批准使用的 API 密钥,或申请创建密钥的权限。如果还没有密钥,请先按照如何充值 Token完成注册、添加额度和创建密钥。

  1. 打开 OpenModels
  2. 登录或注册用于支付模型用量的组织账号。
  3. 购买或开通艾维斯部署获准使用的模型访问权限。
  4. 在 OpenModels 账号中创建或复制 OpenModels API 密钥。
  5. 在粘贴到艾维斯前,请先把密钥保存在团队的密钥管理工具中。

共享部署建议使用生产环境归属的密钥,不要使用个人试用密钥。如果请求提示 OpenModels API Key 余额不足,也请到同一个 OpenModels 账号中检查余额或充值。

页面概览

模型凭证页面,展示一个已同步的 OpenModels 凭证、可用模型数量、刷新、编辑和删除操作

每张凭证卡片代表一把 OpenModels API 密钥及其已同步模型目录。

页面元素含义
凭证名称管理员识别凭证时使用的标签。配置模型时会显示该名称,但不会发送到模型服务。
已遮挡密钥只显示部分密钥,用于确认是哪把密钥;完整密钥不会再次展示。
同步状态可能是“目录已同步”“同步失败”或“从未同步”。密钥变更或模型目录变更后,应刷新目录。
可用 / 不可用模型可用模型可以被艾维斯能力选择;不可用模型只作为目录上下文或兼容性提示。
模型类型数量目录会按语言、图像、视频、STT、TTS 五类汇总。
上次同步显示最近一次目录同步的时间。
卡片操作可编辑名称或密钥、刷新目录、删除凭证。
可用模型抽屉展开卡片后,可按模型类型查看可用模型列表。

添加模型凭证

添加模型凭证弹窗,展示名称和 OpenModels API 密钥字段

  1. 以 Admin 身份登录。
  2. 打开 管理后台 > 模型凭证
  3. 点击 添加凭证
  4. 填写清晰的 名称,例如 公司 OpenModels 密钥生产环境 OpenModels
  5. 粘贴 OpenModels API 密钥
  6. 点击 保存并同步

艾维斯会保存凭证,并立即同步这把密钥可访问的模型目录。同步成功后,凭证卡片会显示“目录已同步”和可用模型数量。同步失败时,请重新打开表单检查密钥,修正后使用刷新按钮重新同步目录。

名称只用于管理员后续识别凭证,不会在模型请求中发送给 OpenModels。

查看可用模型

点击凭证卡片底部的 查看可用模型。展开后,模型目录会按能力分组:

  • 语言:用于对话、Agent 和文本推理。
  • 图像:用于图像生成或图像编辑。
  • 视频:用于文生视频、图生视频或视频编辑。
  • STT:用于语音转文字。
  • TTS:用于文字转语音。

在配置默认模型前,先用这个视图确认预期模型类型已经出现在目录中。

刷新、编辑或删除

操作什么时候使用行为
刷新目录OpenModels 账号新增或失去模型权限,或需要重试失败的同步。艾维斯会用已保存密钥重新拉取当前目录,并更新模型数量。
编辑凭证修改凭证名称或轮换 API 密钥。编辑时如果密钥字段留空,会保留当前已保存密钥;只有粘贴新密钥时才会更新密钥。
删除凭证密钥不再被批准使用,或该环境不再需要它。如果还有模型设置依赖该凭证,艾维斯会阻止删除。请先把相关设置迁移到其他凭证。

编辑或刷新凭证后,如果默认模型或某个能力绑定依赖这个目录,请回到语言模型图像生成视频生成语音页面检查配置。

常见问题

现象检查项
保存并同步 不可点击新建凭证时名称和 API 密钥都是必填项。检查是否只有空格或未填写。
同步失败确认 OpenModels API 密钥有效、未停用,并且艾维斯部署环境能访问 OpenModels API。
预期模型没有出现确认这把密钥在 OpenModels 中有该模型权限,然后刷新目录。
模型显示为不可用目录里存在该模型,但艾维斯无法把它用于对应能力。请选择可用模型,或查看页面中的兼容性差异提示。
删除失败该凭证仍被一个或多个模型设置引用。请先把这些设置迁移到其他凭证。

安全实践

不要把 OpenModels API 密钥粘贴到 Agent 指令、对话消息、源代码、截图、工单或共享文档中。密钥只应通过“模型凭证”表单保存。

不同环境或访问边界建议使用不同凭证。按组织安全流程轮换密钥后,请刷新目录,并确认预期默认模型仍可正常使用。

相关页面