接口简介
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系列模型专为复杂推理任务设计,不支持部分参数:使用技巧
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计费模式,不同模型价格不同:实际费用以控制台显示为准。使用前请确保账户余额充足。
错误处理
常见错误码
错误响应示例
最佳实践
- 使用合适的温度值:创意任务使用0.7-1.0,精确任务使用0.1-0.3
- 设置合理的max_tokens:避免无限制输出导致费用过高
- 善用system消息:设置清晰的角色和任务说明
- 启用流式响应:提升用户体验,实时显示生成内容
- 错误重试机制:实现指数退避重试策略
- 监控使用情况:定期检查控制台的使用统计
查看更多API文档
返回 API 手册,查看其他接口使用方法