导航栏：首页 / AI开发参考资料 / OpenAI API 兼容格式参考资料 / 请求格式概览
请求方式
OpenAI API兼容格式采用HTTP Post方式进行请求，这是与OpenAI官方API保持一致的标准接口设计。
什么是RESTful API？
RESTful API是一种基于HTTP协议的API设计风格，它使用标准的HTTP方法来操作资源。REST（Representational State Transfer）的核心思想是将服务器上的资源通过URL进行标识，并使用HTTP方法（如GET、POST、PUT、DELETE）对这些资源进行操作。
HTTP POST方法介绍
HTTP POST请求是一种用于向服务器提交数据的请求方法，它将数据包含在请求体中发送，适用于需要向服务器发送大量数据的场景，比如调用OpenAI API生成文本。
与GET请求相比，POST请求可以发送更多数据，并且数据不会暴露在URL中，更适合传输敏感信息。在OpenAI API中，POST请求用于向服务器发送对话历史和模型参数，以获取AI生成的回复。
请求格式
调用OpenAI API时，需要通过HTTP POST请求发送JSON格式的数据。一个完整的请求包含以下两部分：
请求头（Headers）
- Content-Type: 必须设置为 application/json，表示请求体是JSON格式
- Authorization: 格式为 Bearer YOUR_API_KEY，用于身份验证
请求体（Body）
请求体是JSON格式的数据，包含模型、对话历史和其他配置参数。以下是一个完整的请求体示例：
{
"model": "gpt-4",
"messages": [
{
"role": "system",
"content": "你是一个有用的助手。"
},
{
"role": "user",
"content": "解释量子计算的基本原理。"
}
],
"temperature": 0.7,
"max_tokens": 150
}这个示例请求体包含了最常用的几个参数，用于向OpenAI API发送一个简单的对话请求。
请求参数
以下是OpenAI API请求中最常用的几个参数：
- model: 指定要使用的模型，如 gpt-4， Qwen3，gemini-2.5-flash等。不同模型具有不同的能力和价格。
- messages: 包含对话历史的消息数组，每条消息包含 role 和 content 字段。role可以是 system、user 或 assistant。
- temperature: 控制生成文本的随机性。较低的值(0.2)使输出更确定、更集中，较高的值(1.0+)使输出更随机、更多样化。
- max_tokens: 控制生成回复的最大令牌数。注意：请求中的令牌数（提示+完成）不能超过模型的最大上下文长度。
更多参数的详细说明，请参考本站的 OpenAI API兼容格式请求参数详解 页面。