Chat Completions 是与 OpenAI 最新模型搭配使用的标准 API。你可以通过我们的文本生成开发者指南了解如何开始使用它。
截至 2025 年 3 月 11 日，我们已经发布了新的智能体平台的构建模块。有关详细信息，请参阅我们的 API 文档：Responses API、包括网页搜索、文件搜索和计算机使用在内的工具，以及带有追踪功能的智能体 SDK。
从提示词到消息
要与我们的模型进行更具互动性、更灵活的对话，可以使用聊天格式的消息，而不是补全功能所用的旧式提示词。
具体工作方式如下：
输入时，您发送的不再是单个提示词字符串，而是一组消息对象。
每条消息都有一个角色，通常还包含内容。
常见角色包括 system、user、assistant、developer 和 tool。工具消息用于返回工具或函数的结果，并且必须与助手发起的工具调用相对应。为保持向后兼容性，服务器在处理时仍可接受函数消息，并将其转换为工具消息。开发者消息可能会根据模型的支持情况重新映射。
内容中包含该角色所发消息的文本。
系统指令可以为对话提供总体指导
消息会按照在列表中的出现顺序进行处理，助手则据此作出响应。
即使是基本的补全请求，也可以通过聊天补全来完成，如下所示：
| 以前 | 现在 |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
现在，只需扩展对话中的消息列表，即可比以往更轻松地与模型来回交流。
'messages': [{'role':'user', 'content':'给我讲个笑话'},
{'role':'assistant', 'content':'鸡为什么要过马路'},
{'role':'user', 'content':'我不知道，鸡为什么要过马路'}]系统指令
你也可以使用系统级指令，在整个对话过程中引导模型的行为。例如，使用系统指令和如下消息
'messages': [{'role':'system', 'content':'你是一个说话像莎士比亚的助手。'},
{'role':'user', 'content':'给我讲个笑话'}, 将得到类似如下的结果
{...
'message': {'role':'assistant',
'content':'鸡为什么要过马路？为了到对面去；但诚然，对面充满艰险，所以它很快又从来处折返，实乃如此！'}
...}如果你想探索无需自行管理消息对话历史的选项，请查看 Assistants API。