---
# AI API 密钥

Odoo 的 **AI** 应用设置包含以下选项：控制应用使用的 `AI（人工智能）` 提供商、管理 `API（应用程序接口）` 凭证，以及定义默认提示。Odoo 在 **AI** 应用中同时支持 Gemini 与 OpenAI（ChatGPT）两种提供商。

某些 `AI（人工智能）` 功能可以在未安装 **AI** 应用的情况下使用。但若要使用自定义的 `API（应用程序接口）` 凭证或更改特定代理使用的 `AI（人工智能）` 提供商，**必须**安装该应用。

:::: important
::: title
重要提示
:::

`API（应用程序接口）` 密钥是 `Odoo.sh </../../../../administration/odoo_sh>` 或 `本地部署 </../../../../administration/on_premise>` 数据库使用 `AI（人工智能）` 功能的必需条件。

`Odoo Online </../../../../administration/odoo_online>` 用户可以自行添加 `API（应用程序接口）` 密钥，但并非强制要求。不过，一些组织可能希望使用自有密钥，以便在权限、版本更新或内部合规方面拥有更大控制权。
::::

## 为 ChatGPT 创建 API 密钥 {#ai/apikeys/chatgpt}

要为 ChatGPT 创建 `API（应用程序接口）` 密钥，请访问 [API 密钥页面](https://platform.openai.com/api-keys)。点击 `登录` 并输入 OpenAI 账户的登录信息。

在 *API 密钥* 页面，点击 `创建新的秘密密钥`。

![OpenAI 中的 API 密钥页面。](apikeys/create-new-key.png)

会弹出 `创建新的秘密密钥` 窗口。请选择新密钥的拥有者：

- `您`：新密钥绑定到用户账户，可对所选项目发起请求。如果用户被从组织或项目中移除，该密钥将被禁用。  
- `服务账户`：为项目创建一个新的机器人成员（服务账户），密钥附属于该机器人成员。

随后，输入该密钥的 `名称`（可选，但建议填写）。然后从下拉菜单中选择 `项目`。最后，选择合适的 `权限`。

![在 OpenAI 中创建新 API 密钥的弹窗。](apikeys/create-key-popup.png)

:::: note
::: title
备注
:::

将 `权限` 设置为 `受限` 时，需要对多个资源分别设置读写权限。更多信息请参阅 [OpenAI 平台文档](https://platform.openai.com/docs/overview)。
::::

点击 `创建秘密密钥`。弹出窗口出现后，点击 `复制` 将新密钥复制下来。

:::: warning
::: title
警告
:::

弹窗关闭后，密钥 **无法再次查看**。若密钥丢失，需要重新创建。
::::

![显示新创建的 OpenAI 密钥的弹窗。](apikeys/save-openai-key.png)

返回 Odoo，进入 `AI 应用 --> 配置 --> 设置`。在 *提供商* 区域，勾选 `使用您自己的 ChatGPT 账户`，并在 `密钥` 字段粘贴刚才复制的密钥。完成后点击 `保存`。

## 为 Google Gemini 创建 API 密钥 {#ai/apikeys/gemini}

要为 Google Gemini 创建 `API（应用程序接口）` 密钥，请访问 [API 密钥页面](https://aistudio.google.com/app/api-keys)。输入 Google 账户的登录信息，点击 `下一步` 进入 Google `AI（人工智能）` Studio。右上角点击 `创建 API 密钥`。

![Gemini API 密钥页面。](apikeys/create-gemini-api-key.png)

在 *创建新密钥* 弹窗中，在 `为密钥命名` 字段填写标题。随后，在 `选择导入的项目` 下拉框中选择已有项目，或导入新项目。点击 `创建密钥`。

在 *API 密钥* 页面，找到相应的密钥并点击复制图标。

![带有复制按钮的新的 Gemini 密钥。](apikeys/copy-gemini-key.png)

返回 Odoo，进入 `AI 应用 --> 配置 --> 设置`。在 *提供商* 区域，勾选 `使用您自己的 Google Gemini 账户`，并在 `密钥` 字段粘贴新密钥。完成后点击 `保存`。

## 定价

使用 `API（应用程序接口）` 密钥调用 `AI（人工智能）` 服务可能会产生额外费用，费用取决于所使用的 `AI（人工智能）` 模型以及各提供商的账户类型。

有关 `ChatGPT <ai/apikeys/chatgpt>` 的定价详情，请访问 [OpenAI API 定价](https://openai.com/api/pricing/)。

有关 `Google Gemini <ai/apikeys/gemini>` 的定价详情，请访问 [Gemini API 定价](https://ai.google.dev/gemini-api/docs/pricing)。

- AI API 密钥
  - Odoo AI 应用设置
    - 选择 AI 提供商（Gemini、OpenAI）
    - 管理 API 凭证与默认提示
  - 重要提示
    - Odoo.sh 与本地部署需 API 密钥
    - Odoo Online 可选使用自有密钥
  - 创建 ChatGPT API 密钥
    - 访问 OpenAI API 密钥页面
    - 登录并创建新秘密密钥
    - 选择拥有者（用户 / 服务账户）
    - 设置名称、项目与权限
    - 复制密钥并在 Odoo 配置
    - 注意权限受限设置
    - 警告：密钥关闭后不可再查看
  - 创建 Google Gemini API 密钥
    - 访问 Google AI Studio API 密钥页面
    - 登录后创建新密钥并命名
    - 选择或导入项目
    - 复制密钥并在 Odoo 配置
  - 定价
    - 费用取决于模型与账户类型
    - ChatGPT 定价链接
    - Gemini 定价链接