Chat Completions API 是一种以消息列表为输入的模型调用方式。它把对话拆成不同角色的 messages，再让模型生成下一条回复。

基本结构

{
  "model": "model-name",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Explain RAG briefly."}
  ]
}

常见角色

  • system：全局行为设定。
  • user：用户输入。
  • assistant：模型历史回复。
  • tool：工具调用结果。

适合学习的点

  • 多轮对话其实是不断把历史消息重新发给模型。
  • prompt 不是只有用户问题，还包括系统指令、上下文、示例和工具结果。
  • 结构化输出和工具调用是 AI 应用工程化的重要入口。

和 Responses API 的关系

Chat Completions 更像传统聊天接口；Responses API 更像统一的模型响应接口，便于组织文本、工具、结构化输出和多模态能力。学习时可以先理解 Chat Completions 的消息模型，再迁移到更统一的接口设计。

本文归档于个人知识库 · 领域：CS & AI · 模块：04 Project_CS_AI/AI apps