1.3 OpenAI API的调用过程
1.3.1 OpenAI API的请求和响应过程
OpenAI API的请求和响应过程如图1.7所示。
序列图具体解释如下。
1．构建API请求
开发者使用HTTP请求来构建API请求，需要指定API的终端URL，并选择适当的HTTP方法（例如POST或GET）。
开发者将API密钥和其他必要的请求参数包括在请求的标头（headers）或查询参数（query parameters）中。请求参数可能包括模型选择、请求类型、生成文本长度等。
图1.7 OpenAI API请求序列图
2．发送API请求
开发者使用合适的HTTP客户端（如cURL、Python的requests库等）发送构建好的API请求。请求将被发送到OpenAI API服务器。
3．服务器处理请求
OpenAI API服务器接收到开发者发送的API请求后，会进行验证和处理。
验证过程会检查API密钥的有效性，确保开发者具有访问API的授权权限。
处理过程会根据请求中的参数和数据选择相应的模型进行处理。
4．模型处理和文本生成
服务器将接收到的文本数据传递给选定的模型进行处理。模型可以是ChatGPT或其他自然语言处理模型。
模型使用深度学习和预训练技术来理解输入文本的上下文、语义和语法，并生成相应的自然语言文本。
5．构建API响应
服务器将生成的文本或其他结果构建成API响应。响应通常是一个包含模型生成文本的JSON对象。
响应可能还包括其他相关信息，如请求ID、模型的元数据等。
6．返回API响应
OpenAI API服务器将构建好的API响应发送回开发者的请求来源。响应通过HTTP响应状态码和响应体的形式返回。
7．处理API响应
开发者接收到API响应后，使用相应的HTTP客户端解析响应。可以提取所需的生成文本或其他相关信息。
开发者可以根据自己的应用需求对生成的文本进行后续处理、展示或其他操作。
1.3.2 OpenAI API的协议和格式
OpenAI API凭借其基于HTTP的通信框架为开发者提供了简便、灵活的接口，方便开发者轻松地访问和使用先进的自然语言处理模型。
1．通信协议
OpenAI API依赖于基于HTTP的通信框架，为开发者提供了一个稳定和标准化的访问方式。通过构建合适的HTTP请求，开发者可以轻松地与OpenAI API互动，并获得所需的输出。与其他服务类似，API的请求和响应遵循标准的HTTP报文结构，这使得开发者可以使用通用的开发工具和库与其进行交互。
2．接口终端
为了满足不同的需求，OpenAI提供了多个API终端，每个终端都对应一个特定的功能或模型。开发者在与API交互时，需要根据实际需求选择正确的终端URL。
3．HTTP请求方法
HTTP请求方法描述了请求的性质和目的。OpenAI API支持多种标准的请求方法，最常用的是POST和GET。通过POST，开发者可以上传数据并请求特定的处理，例如，文本生成或分析。而使用GET，则是为了从API中检索数据或先前生成的结果。
4．请求参数
OpenAI API为了增强灵活性，提供了一系列的请求参数选项。这些参数可以是关于模型的选择、希望获得的输出类型，或者其他与请求相关的细节，如文本生成的最大长度。API密钥是必须的，因为它提供了与OpenAI服务的认证，确保了API的安全性和完整性。
5．请求头
HTTP请求中的请求头部分为开发者提供了向API传达额外信息的机会。这些信息可以是关于请求的元数据，或者是一些特定的指示。常见的请求头信息包括但不限于API密钥、内容的媒体类型或是期望的响应格式。
6．响应格式
与API的交互结果以HTTP响应的形式返回给开发者。这些响应通常包含了模型生成的输出内容，以及与该响应相关的元数据。返回的主体通常采用JSON格式，这是一种轻量级、易于解析的数据交换格式。除了主体内容，响应还会提供其他有用的信息，如HTTP状态码，它可以告诉开发者请求是否成功，以及可能出现的任何错误或问题。