openai key使用教程的进一步展开说明

# OpenAI API快速入门：从补全到利用

## 1. 引言

OpenAI已成功训练了一种优秀的语言模型，它善于理解和生成文本。OpenAI的API为我们提供了访问这些模型的接口，可以利用于几近所有触及“语言处理”任务的场景。

在本快速入门教程中，我们将创建一个简单的示例利用程序。通过这个进程，你将学习怎样使用API来处理各种任务的关键基础概念和技能，包括：

– 内容生成
– 概述
– 分级、分类和情感分析
– 数据提取
– 翻译
– 其他更多

补全（Completion）是OpenAI API的核心功能，它提供了一个灵活而强大的接口。你输入一些文本作为提示（Prompt），API将返回一个匹配你的提示的相关文本作为补全（Completion）。

让我们以一个简单的例子来体验一下这个功能。假定你想为一家冰淇淋店设计一个口号。

## 2. 为冰淇淋店设计一个标语

输入提示（Prompt）: 为冰淇淋店设计一个标语。

返回补全（Completion）: 用每勺都带来微笑！

可以把它看做是一个高级的自动补全功能，模型会处理你的文本提示，并尝试预测并返回最适合的内容。

## 3. 创造一个宠物名字生成器

现在假定你想创建一个宠物名字生成器。从头开始想出这些名字可能会很困难。

首先，我们需要一个清晰描写你想要的名字的提示。让我们试试以下提示，看看能否得到一些补全（Completion）的建议。

输入提示（Prompt）：为一匹马建议一个名字。

返回补全（Completion）：闪电

再试试让你的唆使更具体。

输入提示（Prompt）：为一匹黑马建议一个名字。

返回补全（Completion）：午夜

如你所见，通过在提示中添加形容词，返回的补全（Completion）会有所区别。设计提示本质上就是对模型进行“编程”。

设计好的提示对取得良好的结果很重要，但有时仅仅这样还不足够。让我们尝试下更复杂的唆使。

输入提示（Prompt）：为一只超级英雄马建议三个名字。

返回补全（Completion）：

1. 超级种马
2. 爱国小驹
3. 威名无敌的野马

这个结果其实不是我们想要的。这些名字太通用了，而且模型仿佛没有理解我们唆使中的“马”的要求。让我们试试能否得到一些更相关的建议。

在许多情况下，通过在提示中添加示例可以更好地告知模型你想要甚么。尝试提交一个包括示例的提示，以便转达模式或细微差别。

输入提示（Prompt）：为一只超级英雄动物建议三个名字。

**动物：猫**

**名字：船长利爪、特工绒球、无敌猫咪**

**动物：狗**

**名字：保卫者狂吠、奇迹犬、吠叫爵士**

**动物：马**

**名字：**

返回补全（Completion）：超级种马、强大的母马、壮丽的马

很好！通过添加我们希望生成的输出示例，模型能够提供我们正在寻觅的名称类型。

## 4. 提高生成的名字的多样性

提示的设计不是你唯一可使用的工具。你还可以通过调剂设置来控制补全（Completion）的生成。其中一个最重要的设置是温度（Temperature）。

你可能已注意到，如果在上面的示例中屡次提交相同的提示，模型将始终返回相同或非常类似的补全（Completion）。这是由于你设置的温度（Temperature）为0。

尝试将温度（Temperature）设置为1，并屡次提交相同的提示。

输入提示（Prompt）：为一只超级英雄动物建议三个名字。

**动物：猫**

**名字：船长利爪、特工绒球、无敌猫咪**

**动物：狗**

**名字：保卫者狂吠、奇迹犬、吠叫爵士**

**动物：马**

**名字：**

返回补全（Completion）：

超级种马、强大的马、神话般的纯种马

你注意到产生了甚么吗？当温度大于0时，每次提交相同的提示都会返回区别的补全（Completion）。

请记住，该模型预测哪一个文本最有可能跟在它前面的文本以后。温度（Temperature）是一个介于0和1之间的值，它可以用来控制模型进行这些预测时的置信度。下降温度（Temperature）意味着模型将承当更少的风险，并且生成的补全（Completion）将更准确和肯定。而提高温度（Temperature）则会致使生成的补全（Completion）更加多样化。

对宠物名字生成器，你可能希望能够生成很多创意名字。使用温度0.6应当能够得到比较理想的效果。

现在你找到了一个不错的提示和设置，下面让我们来构建自己的宠物名字生成器吧！我们编写了一些代码来帮助你入门，请依照以下说明下载代码并运行利用程序。

## 5. 宠物名字生成器示例利用

如果你还没有安装Node.js，请从官方网站下载并安装。然后通过克隆这个[代码库](https://github.com/openai/openai-quickstart-node.git)来获得代码。

`git clone https://github.com/openai/openai-quickstart-node.git`

如果不想使用git，你也能够在 [这里](https://github.com/openai/openai-quickstart-node/archive/refs/heads/main.zip) 下载代码。

在项目目录中进入以下命令安装依赖并运行利用程序。

“`
cd openai-quickstart-node
npm install
npm run dev
“`

在浏览器中打开 [http://localhost:3000](http://localhost:3000)，你将看到宠物名称生成器的界面！

在 openai-quickstart-node/pages/api 文件夹下打开 generate.js 文件。在文件底部，你会看到用于生成我们上面提到的提示的函数。用户输入宠物的类型后，它会动态输出相应动物的提示。

“`
function generatePrompt (animal) {
const capitalizedAnimal =
animal[0].toUpperCase() + animal.slice(1).toLowerCase();
return `为一只超级英雄动物建议三个名字。

**动物：猫**

**名字：船长利爪、特工绒球、无敌猫咪**

**动物：狗**

**名字：保卫者狂吠、奇迹犬、吠叫爵士**

**动物：${capitalizedAnimal}**

**名字：**
`;
}
“`

在 generate.js 的第9行，你会看到用于发送实际API要求的代码。正如前面所说，它使用一个温度为0.6的补全（Completion）点来履行。

“`
const completion = await openai.createCompletion({
model: “text-davinci-003”,
prompt: generatePrompt(req.body.animal),
temperature: 0.6,
});
“`

是的，就是这样！现在你完全了解了怎样使用OpenAI的API构建宠物名字生成器！

这些概念和技能将帮助你构建自己的利用程序。不但限于宠物名字生成器，API的补全（Completions）端点非常灵活，几近可以处理任何触及“语言处理”的任务，包括内容生成、摘要、语义搜索、主题标记、情感分析等等。

需要记住的一个限制是大多数模型在单个API要求中最多处理2048个标记（约1500个单词）的文本。同时还提供使用量计费，每1000个标记的价格不等于于3美元。了解更多请参考开发者网站。

对更高级的任务，你可能会发现希望能够提供更多的示例或上下文以定制模型。这时候候微调（Fine-tuning）API就是一个绝佳的选择，它允许你提供数百乃至数千个示例来为你的特定用例定制模型。

希望这个快速入门教程对你有所帮助，并为你往后的开发工作提供了一些启发！如果想要取得更多关于如何设计提示的灵感和技能，请参考OpenAI网站上的相关文档。

openai key使用教程的常见问答Q&A