Chat Completions Basics

Chat Completions 现在更适合两个场景：维护老项目，或者做渐进迁移。按 OpenAI 官方迁移文档，新项目推荐优先使用 Responses API，但 Chat Completions 仍然支持，所以它不会立刻失去价值。

#什么时候还会用 Chat Completions

• 现有项目已经大量使用 messages
• 不想一次性重写调用层
• 需要一边跑线上，一边逐步迁移到 Responses

如果你是从零开始做新接口，这页可以了解，但不建议把它当默认起点。

#它的核心心智

• 输入是一组 messages
• 每条 message 有 role
• 你需要自己管理多轮上下文

这和 Responses API 的 unified item / response 心智不太一样。

#一个最小示例

python复制
from openai import OpenAI

client = OpenAI()

response = client.chat.completions.create(
    model="gpt-5",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain what an API is in 3 sentences."}
    ]
)

print(response.choices[0].message.content)

#什么时候该开始迁移

如果你已经准备接：

• tools
• image input
• 更统一的多轮状态
• 新的 agent-style workflow

那就不要继续在 Chat Completions 上加太多新投资了，应该开始规划迁到 Responses API。

#Related pages

• OpenAI API overview
• Quickstart
• Function calling