模型凭证
模型凭证
“模型凭证”用于把 OpenModels API 密钥连接到艾维斯。每个已保存的凭证会加密存储一把 API 密钥,同步这把密钥可访问的模型目录,并把这些模型提供给后续模型配置页面选择。
添加凭证不等于自动启用所有模型,也不会自动替换默认模型。目录同步完成后,请继续到语言模型以及图像、视频、语音等能力页面,选择实际要启用的模型。
准备事项
获取 OpenModels API 密钥
如果组织已经有 OpenModels 账号,请向账号 owner 获取工作区批准使用的 API 密钥,或申请创建密钥的权限。如果还没有密钥:
- 打开 OpenModels。
- 登录或注册用于支付模型用量的组织账号。
- 购买或开通艾维斯部署获准使用的模型访问权限。
- 在 OpenModels 账号中创建或复制 OpenModels API 密钥。
- 在粘贴到艾维斯前,请先把密钥保存在团队的密钥管理工具中。
共享部署建议使用生产环境归属的密钥,不要使用个人试用密钥。如果请求提示 OpenModels API Key 余额不足,也请到同一个 OpenModels 账号中检查余额或充值。
页面概览

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

- 以 Admin 身份登录。
- 打开 管理后台 > 模型凭证。
- 点击 添加凭证。
- 填写清晰的 名称,例如
公司 OpenModels 密钥或生产环境 OpenModels。 - 粘贴 OpenModels API 密钥。
- 点击 保存并同步。
艾维斯会保存凭证,并立即同步这把密钥可访问的模型目录。同步成功后,凭证卡片会显示“目录已同步”和可用模型数量。同步失败时,请重新打开表单检查密钥,修正后使用刷新按钮重新同步目录。
名称只用于管理员后续识别凭证,不会在模型请求中发送给 OpenModels。
查看可用模型
点击凭证卡片底部的 查看可用模型。展开后,模型目录会按能力分组:
- 语言:用于对话、Agent 和文本推理。
- 图像:用于图像生成或图像编辑。
- 视频:用于文生视频、图生视频或视频编辑。
- STT:用于语音转文字。
- TTS:用于文字转语音。
在配置默认模型前,先用这个视图确认预期模型类型已经出现在目录中。
刷新、编辑或删除
编辑或刷新凭证后,如果默认模型或某个能力绑定依赖这个目录,请回到语言模型、图像生成、视频生成和语音页面检查配置。
常见问题
安全实践
不要把 OpenModels API 密钥粘贴到 Agent 指令、对话消息、源代码、截图、工单或共享文档中。密钥只应通过“模型凭证”表单保存。
不同环境或访问边界建议使用不同凭证。按组织安全流程轮换密钥后,请刷新目录,并确认预期默认模型仍可正常使用。