# 如何获取你的 OpenAI API 密钥

*当 Mampu AI 在 **Settings > Integrations > AI Providers** 中要求提供 OpenAI API 密钥时，请参考本指南。同一个密钥也可能被称为 OpenAI 密钥、项目 API 密钥、平台密钥或 API 令牌。*

## 观看教程

{% embed url="https://youtu.be/pSJDuCkgsIM" %}

在 OpenAI Platform 中创建密钥后，将其添加到 **AI Providers** 页面（**Settings > Integrations > AI Providers**）的 **OpenAI** 卡片中。

## 开始之前

* 使用一个由你自己掌控的 OpenAI Platform 账户。
* 确认你所在的 OpenAI 组织和项目是正确的。
* 如果 OpenAI 要求你充值，请在使用密钥之前选择一个套餐并添加付款方式。
* 请对密钥保密。任何持有该密钥的人都可以代表你发起 API 请求。

## 在 OpenAI Platform 引导流程中创建密钥

**1.** 前往 [platform.openai.com/login](https://platform.openai.com/login)，输入你的 OpenAI 账户邮箱地址，然后点击 **Continue**。如果你的 OpenAI 账户已配置，也可以使用 Google、Apple、Microsoft 或手机号继续。

![OpenAI Platform 登录界面](../../.gitbook/assets/guides/93b0fa6b-image1.jpg)

**2.** 打开 OpenAI 发送的验证邮件，在 **Check your inbox** 界面输入验证码，然后点击 **Continue**。

![OpenAI 邮箱验证界面](../../.gitbook/assets/guides/d826bc95-image2.jpg)

**3.** 填写个人资料字段，包括 **Full name** 和 **Age**，然后点击 **Finish creating account**。

![OpenAI 账户资料设置界面](../../.gitbook/assets/guides/92512ce9-image3.jpg)

**4.** 在 **Welcome to OpenAI Platform** 界面，输入 **Organization name** 和 **Project name**，然后点击 **Continue**。你在此处选择的项目即为该 API 密钥所属的项目。

![OpenAI 组织与项目设置界面](../../.gitbook/assets/guides/4331161f-image4.jpg)

**5.** 在 **Choose your plan** 界面，选择与你的使用量相匹配的套餐。界面可能会显示 **Free**、**Prototype** 或 **Accelerate** 等选项。如果你需要更高的使用量或权限，请选择付费套餐。

![OpenAI 套餐选择界面](../../.gitbook/assets/guides/9595d7b5-image5.jpg)

**6.** 如果 OpenAI 要求付款，请添加付款方式并继续。除非你信任正在设置的账户和项目，否则不要输入银行卡信息。

![OpenAI 添加付款方式界面](../../.gitbook/assets/guides/60e5938f-image6.jpg)

**7.** 在 **Make your first API call** 界面，输入一个清晰的 **API key name**，例如 `Mampu AI OpenAI`，然后点击 **Generate API Key**。

![OpenAI 生成首个 API 密钥界面](../../.gitbook/assets/guides/415a23c9-image7.jpg)

**8.** 密钥生成后，点击 **Copy** 并保存到安全的密码管理器中。OpenAI 只会完整显示一次密钥。如果丢失了它，请创建一个新密钥并在 Mampu AI 中替换旧的值。

![OpenAI 生成的 API 密钥界面](../../.gitbook/assets/guides/e062b8f5-image8.jpg)

## 在已有的 OpenAI Platform 账户中创建密钥

**1.** 打开 [platform.openai.com/home](https://platform.openai.com/home)，确认左侧边栏中已选中正确的项目。如果你的剩余额度是 `0.00`，请在生产环境中使用密钥前先充值。

![OpenAI Platform 主页界面](../../.gitbook/assets/guides/28dc1e68-image9.jpg)

**2.** 在左侧边栏中点击 **API Keys**，进入 **API keys** 页面，你可以在这里查看现有密钥并创建新密钥。

![OpenAI API keys 页面](../../.gitbook/assets/guides/813bb9a6-image10.jpg)

**3.** 点击 **Create new secret key**。

![OpenAI 创建新密钥按钮](../../.gitbook/assets/guides/2641c975-image11.jpg)

**4.** 在 **Create new secret key** 弹窗中，输入一个名称，例如 `Mampu AI OpenAI`，选择正确的 **Project**，然后点击 **Create secret key**。

![OpenAI 创建新密钥弹窗](../../.gitbook/assets/guides/a33991f9-image12.jpg)

**5.** 在 **Save your key** 界面，点击 **Copy** 并妥善保存密钥。保存完成后再点击 **Done**。

## 将密钥添加到 Mampu AI

**1.** 在 Mampu AI 中，前往 **Settings > Integrations > AI Providers**。
**2.** 在 **FAQ, knowledge & media processing** 下找到 **OpenAI** 卡片。
**3.** 粘贴复制的密钥并连接。
**4.** 密钥被接受后，卡片会显示 **Connected**。

OpenAI 密钥为 AI Knowledge（FAQ 生成与搜索）、语音留言转写、图像理解和文章翻译提供支持。

## 疑难排解

* 如果 OpenAI 集成失败，请确认复制的值是完整的密钥，而不仅仅是追踪 ID。
* 如果设置完成后 AI 回复、摘要、语法修正、标签或 Copilot 功能出现故障，请检查 OpenAI 项目是否有额度，以及密钥是否仍然有效。
* 如果密钥意外泄露或被分享，请从 OpenAI 的 **API Keys** 页面删除它，并创建一个新密钥。
* 如果你使用多个 OpenAI 项目，请在应承担 Mampu AI 使用费用的那个项目中创建密钥。

---
Source: https://help.mampuai.com/zh/mampu-ai/settings/how-to-get-your-openai-api-key