引言
在现代软件开发中,Web API(Application Programming Interface)
的使用已经变得非常普遍。我们可以利用API
与不同的服务进行交互,从而获取数据或执行操作,经过一段时间的学习我也开始接触到了API
。OpenAI
是一家提供自然语言处理能力的公司,其API
提供了强大的文本生成功能,我们可以通过调用它的API
完成许多任务。在本文中,我们将一起来尝试一下使用 Postman
向 OpenAI
发送请求并获取返回值,只要我们跨出了第一步,之后的路都可以渐渐明朗~
步骤1:获取OpenAI API密钥
首先,既然我们需要调用OpenAI
的API
,那我们肯定需要获得一个OpenAI API
密钥。你可以注册OpenAI
的帐户并创建一个账户(要注意现在正常途径从中国注册账号是不行的,大家可以在网上找到很多注册方式),然后在那里生成一个API密钥
。将API密钥
保存在一个安全的地方,因为它将用于向OpenAI
发送请求,而任何人获得这个密钥都可以向OpenAI
发送请求,而OpenAI
接口的调用是需要花钱的(新的账号会有5美元的额度)。
步骤2:下载和安装Postman
如果你尚未安装Postman,可以在其官方网站上下载并安装这个强大的API测试工具。Postman提供了直观的界面,用于构建、发送和调试HTTP请求。当然我们直接使用它的网页也是可以的:
这是我们将要操作的地方,点进去和我们这里不太一样也不用着急,继续看下去~
步骤3:创建一个新请求
在Postman中,我们可以创建一个新请求并且为其命名,以便更好地管理我们的API请求。
让我们来看看怎么进到我们需要的页面,并且创建一个新的请求吧:
首先我们要点击Workspaces然后找到我的工作空间(My Workspaces)然后在右边点击加号创建一个新的请求。
或者我们可以点击Postman界面左上角的“New”按钮,选择“HTTP”来创建一个新请求:
步骤4:配置请求参数
现在,我们需要配置请求参数以使用OpenAI的API。在Postman中,你可以指定请求的HTTP方法、URL和请求头,对这些要是不太清楚可以看看这篇文章: 揭秘网络通信的密码:HTTPS、IP和HTTP状态码,为了与OpenAI的文本生成API进行交互,我们应该使用POST请求来调用API接口,URL应该是OpenAI的API端点,然后我们在请求头中添加密钥验证我们的身份:
- HTTP方法:选择“POST”
我们在这里选择POST。
- URL:
OpenAI
的API端点
,现在我用的是https://api.openai.com/v1/completions
。之后我们也可以参考OpenAI
的官方文档来获取最新的合适的API端点。
在这里填入URL接口。
在请求头中,我们需要设置Authorization
头,将我们的OpenAI API
密钥添加到其中。通常是以Bearer Token
的形式传递的。
我们找到Authorization
然后点击Type
下拉选择框,选择Bearer Token
,并且填入密钥,一般OpenAI
的API密钥
都是sk-XXX
。
步骤5:定义请求体
如果只有前面的操作我们只能够连接到OpenAI,我们接下来应该在请求体中带上我们的请求,在Postman
的请求体中,我们可以定义我们的请求参数。对于OpenAI
的文本生成API
,我们需要指定一些关键信息,包括要生成的文本、模型名称和其他的选项。这些选项可以根据我们的需求进行配置。
我们首先到Body
处,然后点击raw并在右边选择JSON
,然后填入我们的请求体,我们使用了一个叫text-davinci-003
的模型(model)
并且包含了一个提示词“你好”
,temperature
是让OpenAI
自由发挥的程度为0-2
我们可以暂时不考虑。
步骤6:发送请求
当我们完成了这些请求的配置后,我们就可以点击Postman
界面右上角的“Send”按钮来发送请求。Postman
将向OpenAI
的API
发送请求并等待响应。
步骤7:获取响应
当Postman收到了来自OpenAI API的响应,我们就可以在Postman的界面中查看它。一般来说OpenAI的文本模型会返回生成的文本或其他相关信息,这是根据你的请求来决定的。
OpenAI
返回了一个choices
对象数组给我们,其中就包含它回复的text
也就是你好
。
结论
通过使用Postman
,我们就可以轻松地向OpenAI
发送请求并获取文本生成的结果。同样的方式还有很多,例如我们还可以通过python
的库来对OpenAI
的接口发送请求,从而用于各种用途的开发,例如聊天机器人、文章生成和自动回答等。从这一次小小的实验开始摸索,我们就可以开始尝试用各种方法调用OpenAI
的API
接口实现我们想要的效果,并慢慢开始构建一些简单的应用程序。
那么我们这篇文章到这里就结束啦,之后我还会写一篇关于使用python
调用的示例文章~
如果你想了解更多这类文章,点赞关注作者更新更多后续~