Skip to main content

接口简介

Chat Completions 是老张API最核心的接口,用于与AI模型进行对话交流。支持200+AI模型,包括OpenAI、Claude、Gemini、DeepSeek等所有主流大模型。

接口信息

接口地址POST https://api2.laozhang.ai/v1/chat/completions 兼容性:完全兼容OpenAI官方API格式

请求参数

必需参数

可选参数

消息格式

基础消息格式

支持的角色类型

  • system:系统消息,用于设置AI的行为和角色
  • user:用户消息,用户的输入内容
  • assistant:助手消息,AI的回复内容
  • function:函数消息(OpenAI模型支持)
  • tool:工具消息(部分模型支持)

多模态消息格式

对于支持图片理解的模型(如GPT-4o、Gemini Pro Vision),可以发送包含图片的消息:

请求示例

响应格式

标准响应

响应字段说明

finish_reason 取值

  • stop:自然结束
  • length:达到max_tokens限制
  • content_filter:触发内容过滤
  • function_call:调用函数(OpenAI模型)
  • tool_calls:调用工具(部分模型)

流式响应

设置 "stream": true 可以启用流式响应,实时获取生成内容:

流式响应格式

不同模型的特殊用法

GPT-4o Vision (图像理解)

Claude 原生格式

Claude模型同时支持OpenAI格式和原生格式。使用原生格式时,需要调用 /v1/messages 端点:

O1 系列推理模型

O1系列模型专为复杂推理任务设计,不支持部分参数:
O1系列模型不支持 temperaturetop_pfrequency_penalty 等参数,也不支持 system 角色消息。

使用技巧

1. 选择合适的模型

  • 推荐:GPT-4o Mini、Claude 3.5 Haiku
  • 特点:响应快、成本低、质量好
  • 推荐:GPT-4o、Claude 3.5 Sonnet、DeepSeek Coder
  • 特点:代码理解能力强、生成质量高
  • 推荐:O1 Preview、Claude 3 Opus
  • 特点:逻辑推理能力强、适合数学问题
  • 推荐:通义千问、GLM-4、文心一言
  • 特点:中文理解和生成能力优秀

2. 优化提示词

3. 控制输出长度

4. 使用停止词

计费说明

老张API采用按Token计费模式,不同模型价格不同:
实际费用以控制台显示为准。使用前请确保账户余额充足。

错误处理

常见错误码

错误响应示例

最佳实践

  1. 使用合适的温度值:创意任务使用0.7-1.0,精确任务使用0.1-0.3
  2. 设置合理的max_tokens:避免无限制输出导致费用过高
  3. 善用system消息:设置清晰的角色和任务说明
  4. 启用流式响应:提升用户体验,实时显示生成内容
  5. 错误重试机制:实现指数退避重试策略
  6. 监控使用情况:定期检查控制台的使用统计

查看更多API文档

返回 API 手册,查看其他接口使用方法