首页/AI/AI 应用速查/Chat Completions 接口(/v1/chat/completions)

Chat Completions 接口(/v1/chat/completions)

最通用的对话补全协议:POST JSON(model + messages),返回 choices[0].message.content;由 OpenAI 定义后成为行业事实标准,被绝大多数厂商兼容。

AI 应用速查AI更新于 2026-10-12
方法POST
路径/v1/chat/completions
鉴权Authorization: Bearer <API_KEY>
关键字段model、messages、stream、tools、temperature

最小调用(curl)

最小调用(curl)
curl -s https://api.openai.com/v1/chat/completions -H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"用一句话解释 HTTP 404"}]}'
响应 usage 含 prompt_tokens / completion_tokens / total_tokens,是计费对账的依据。

易错点

  • 忽略 finish_reason=length:调用成功但输出已被截断
  • messages 里塞空 content 或混入非字符串字段

数据来源与参考

  • OpenAI Chat Completions API 参考

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌