使用文档数据库 MongoDB 版的 Auto Embedding 功能时，需调用方舟的向量模型。本文介绍如何获取方舟 API Key，并将其配置至 MongoDB 控制台。 ## 前提条件 * 已创建 MongoDB 8.3 及以上版本的实例。具体操作步骤，请参见[创建实例](https://www.volcengine.com/docs/6447/100727)。 * 实例状态为**运行中**。关于实例状态的更多详情，请参见[实例状态](https://www.volcengine.com/docs/6447/99778)。

说明

当前 MongoDB 8.3 版本正在灰度发布中，如需使用 Auto Embedding 功能，或在实例详情页没有看到 AI 能力页签，请提交工单联系技术申请使用。

## 注意事项 API Key 是调用方舟模型服务的重要凭证，创建后长期有效。请勿将密钥信息共享至公开环境，妥善保管并定期轮换密钥，避免因未经授权的使用造成安全风险。 ## 操作步骤 ### 步骤一：开通向量模型服务 1. 登录[方舟控制台](https://console.volcengine.com/ark)。 2. 在左侧导航栏，选择**开通管理**。 3. 在**开通管理**页面，单击**模型**页签，然后选择**向量模型**子页签。 4. 在模型列表中，找到目标模型 **Doubao\-embedding\-vision**，在右侧**操作**列单击**开通服务**。 5. 在弹出的对话框中，打开**模型算力计费**开关，勾选**已阅读并同意《方舟平台专用条款》《免责声明》《豆包模型服务协议》《开源模型许可证》** ，然后单击**确定开通与授权**。关于计费规则与价格，请参见[模型价格](https://docs.volcengine.com/docs/82379/1544106?redirect=1&lang=zh#e68ea83c)。开通向量模型服务的完整流程如下图所示。![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e620c12690b38ac1cefa4b572f1b059f.png) 开通后，模型状态显示为**已开通**，则表示模型已可使用。若后续不再使用，可在右侧**操作**列单击**关闭服务**。 ### 步骤二：创建并复制 API Key 1. 在[方舟控制台](https://console.volcengine.com/ark)左侧导航栏，选择 **API Key 管理**。 2. 在 **API Key 管理**页面，单击**创建 API Key**。详情如下图所示。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_47bcd630a0e9dbebb31716908e7cffd0.png) 3. 在弹出的对话框中，确认或修改**名称**文本框中的 API Key 名称，单击**创建**。详情如下图所示。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f33f36257579edba9e04d06bf1b88497.png) 4. 在 API Key 列表中，找到刚刚创建的 API Key，单击**复制**并妥善保存。详情如下图所示。![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8c346a5c94bbcacdbd45c86c3e6a5cfd.png) ### 步骤三：配置至 MongoDB 控制台 1. 登录 [MongoDB 控制台](https://console.volcengine.com/db/mongodb)。 2. 在顶部菜单栏，选择实例所属的项目和地域。 3. 根据实例类型，在左侧导航栏中选择**副本集实例列表**或**分片集实例列表**。 4. 在目标实例类型列表页，单击目标实例名称，进入实例详情页。 5. 在 **AI 能力**页签的 **API Key 管理**子页签中，将复制的 API Key 粘贴至**方舟 API Key** 输入框。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a22c806488111b5df963e17a528c0970.png) 6. 单击**校验并保存**。若校验失败，请确认 API Key 是否有效且具备模型调用权限。如问题仍未解决，请[提交工单](https://console.volcengine.com/workorder/create/)联系技术支持。 ## 后续操作完成 API Key 配置后，您可以创建 Auto Embedding 类型的向量索引。写入数据时，MongoDB 会自动调用方舟模型生成向量，随后即可通过 `$vectorSearch` 执行向量搜索。更多信息，请参见 [MongoDB Vector Search Quick Start Tutorial](https://www.mongodb.com/zh-cn/docs/vector-search/tutorials/quick-start/)。