Chat Completions API 参考

直接答案

使用 POST https://api2.laozhang.ai/v1/chat/completions 发送消息数组并获取模型回复。老张API提供 OpenAI 兼容调用入口，但“兼容入口”不等于所有模型、参数、工具、流式事件和错误行为都与 OpenAI 完全相同；必须按模型、API Key 分组和实际请求验证。本页最后核对日期为 2026 年 9 月 2 日。OpenAI 官方协议参考：Chat Completions API。老张API当前模型、分组和价格以控制台为准。

请求

Method：POST
URL：https://api2.laozhang.ai/v1/chat/completions
Authorization：Bearer YOUR_LAOZHANG_API_KEY
Content-Type：application/json

curl "https://api2.laozhang.ai/v1/chat/completions" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "messages": [
      {"role": "user", "content": "请只回复：连接成功"}
    ]
  }'

使用前请从模型与价格总表复制实际可用的模型 ID；示例模型不代表所有账户分组都已开放。

核心字段

字段	必需	说明
`model`	是	控制台和模型总表中的准确模型 ID
`messages`	是	按顺序排列的消息数组
`stream`	否	请求流式输出；具体事件和 usage 行为需实测
`temperature` / `top_p`	条件性	并非所有模型都支持；通常不要同时调整
`max_tokens` / `max_completion_tokens`	条件性	字段名和上限取决于模型与兼容层
`tools` / `tool_choice`	条件性	工具定义、并行调用和事件格式必须逐模型验证
`response_format`	条件性	JSON mode 或 structured output 支持不能从模型名推断

不要把某个模型的默认值复制成全站通用默认值。未知字段可能被拒绝、忽略或由兼容层转换；生产前需要用错误用例验证。

消息角色

常见角色包括 developer、system、user、assistant 和 tool。OpenAI 官方文档说明，新一代模型可能优先使用 developer 指令；老张API及非 OpenAI 上游是否接受和如何转换这些角色，需按当前模型实测。

{
  "role": "user",
  "content": "请总结这段文本"
}

多模态 content、音频、文件或图片块仅在目标模型和路由明确支持时使用。

响应与验收

非流式 OpenAI 兼容响应通常包含：

id、object、created、model；
choices[]；
choices[].message；
choices[].finish_reason；
可用时的 usage。

不要只检查 HTTP 200。至少确认：

choices[0].message.content 或工具调用字段符合预期；
流式响应能以客户端支持的方式正常结束；
usage 与控制台调用日志一致；
无效参数、无权限模型和余额不足返回可处理的错误；
重试不会造成重复计费或重复副作用。

错误处理

状态	常见检查
400	JSON、字段、类型、模型参数和上下文长度
401	Authorization 格式和 API Key 是否有效
403	API Key 分组、模型权限、账户或地区限制
404	endpoint 或模型 ID 是否准确
429	余额、速率限制、并发和上游容量
5xx / 超时	路由、上游、网络；仅对临时错误做有限退避重试

排查时记录请求时间、模型、端点、API Key 分组和脱敏错误，并查看调用日志。

核心接口

模型指南

Chat Completions API 参考

直接答案

请求

核心字段

消息角色

响应与验收

错误处理

相关文档

​直接答案

​请求

​核心字段

​消息角色

​响应与验收

​错误处理

​相关文档

直接答案

请求

核心字段

消息角色

响应与验收

错误处理

相关文档