[具身智能-473]：OpenAI Chat Completions API详细解析

OpenAI 的Chat Completions API是目前大模型应用开发中最基础、最核心的接口。你可以把它想象成一个“超级智能的文本处理工厂”你给它发送一堆文本请求它经过处理后给你返回一段生成的文本响应。为了让你通俗易懂地掌握它我将从核心概念、请求结构、响应解析以及关键参数四个方面为你详细拆解。1. 核心概念它是怎么工作的简单来说这个 API 的核心逻辑是“补全”。虽然我们现在用它来聊天但本质上它是根据你提供的上下文Context预测并补全接下来最可能出现的内容。输入一段包含历史对话和当前问题的文本列表。输出AI 生成的回复文本。特点它是无状态的。这意味着服务器不会自动记住你上一句话说了什么你必须在每次请求时把之前的聊天记录历史消息重新发给它。2. 请求结构你要发给它什么调用这个接口通常使用POST /v1/chat/completions。你需要构造一个 JSON 数据包其中最核心的字段是messages。消息列表 (Messages)这是 API 的灵魂。你需要把对话组织成一个列表每一条消息都有两个属性role角色和content内容。角色 (Role)含义作用system(大模型本身的临时角色)系统指令设定人设。比如“你是一个严厉的英语老师”或“你是一个Python专家”。它决定了 AI 的基调。user(本次用户的输入信息)用户输入你的提问。这是你发给 AI 的内容。assistant上下文信息AI 回复历史记录。如果你想让 AI记住之前的对话需要把 AI 之前的回复也放回到这个列表里。代码示例 (Python)pythonimport openai client openai.OpenAI(api_key你的API_KEY) response client.chat.completions.create( modelgpt-4o, # 指定模型 messages[ {role: system, content: 你是一个乐于助人的助手。}, # 1. 设定人设 {role: user, content: 你好请介绍一下你自己。}, # 2. 用户提问 ] )3. 响应解析它会返回什么API 返回的 JSON 数据中你最需要关注的是choices字段。choices这是一个列表通常包含一个或多个生成的回答如果你设置了n 1。message在choices里面你会找到message对象。content这才是真正的“干货”——AI 生成的具体文本内容。返回数据示例{ id: chatcmpl-123, object: chat.completion, choices: [ { index: 0, message: { role: assistant, content: 你好我是 GPT-4一个由 OpenAI 训练的人工智能助手。 }, finish_reason: stop } ], usage: { prompt_tokens: 25, completion_tokens: 18, total_tokens: 43 } }注意usage字段告诉你这次对话消耗了多少 Token也就是钱。4. 关键参数如何控制 AI 的表现除了messages还有几个参数决定了 AI 怎么“说话”表格参数通俗解释推荐设置model大脑型号。选择你要调用的模型如gpt-4o聪明、贵、gpt-3.5-turbo快、便宜。根据需求选temperature创造力/随机性。•0 (低)严谨、确定。适合做数学题、写代码。•1 (高)发散、有创意。适合写小说、写诗。默认 0.7max_tokens回答长度限制。限制 AI 最多生成多少个词Token。防止它啰嗦个没完或者为了省钱。默认不限stream打字机模式。•False等 AI 写完所有字一次性返回延迟高。•TrueAI 写一个字返回一个字体验好像聊天一样。聊天推荐True5. 进阶玩法流式输出与工具调用流式输出 (Streaming)如果你在做聊天机器人必须开启streamTrue。这样 API 会通过 SSE (Server-Sent Events) 协议一段一段地把数据推给你用户就能体验到“字是一个个蹦出来”的效果而不是盯着屏幕转圈等待。工具调用 (Function Calling / Tools)这是 Chat Completions API 的强大之处。你可以在请求中告诉 AI“我有计算器、天气查询等工具”。AI 不会直接回答你而是会返回一个“我想调用这个工具”的指令JSON 格式你的代码接收到指令后去执行再把结果喂回给 AIAI 最终生成回答。总结Chat Completions API就是你组装好messages带上人设和历史。设置好temperature控制性格。发给/v1/chat/completions。从choices.message.content里拿到结果。这就是目前全球最主流的大模型交互标准。