通用文本对话接口文档
一、简介
二、请求参数
| 参数名 | 类型 | 必需 | 说明 | 示例值 |
|---|---|---|---|---|
| api_key | 字符串 | 是 | 访问API的密钥，用于身份验证 | sk - XyLy**************************mIqSt |
| base_url | 字符串 | 是 | API服务的基础 地址，指定模型服务的访问路径 | https://llm.ai-nebula.com |
| model | 字符串 | 是 | 用于生成回答的大语言模型标识 | claude - sonnet - 4 - 20250514 GPT-4o |
| messages | 数组 | 是 | 对话消息列表，包含系统角色定义和用户提问 每个元素为对象，包含： - role：角色(user/system/assistant) - content：消息内容 | { "role": "user", "content": "你好" } |
| temperature | 数字 | 否 | 控制生成内容的随机性，0 - 2值越高回复随机性越强 | 0.7 |
三、返回值说明
（一）成功响应
人工智能是研究、开发用于模拟、延伸和扩展人的智能的理论、方法、技术及应用系统的一门新的技术科学，它试图了解智能的实质，并生产出一种新的能以人类智能相似的方式做出反应的智能机器。（二）错误响应
四、错误处理
| 异常类型 | 触发 场景 | 返回信息 |
|---|---|---|
| AuthenticationError | API密钥无效、过期或未授权 | 错误：API密钥无效或未授权 |
| NotFoundError | 指定的模型ID不存在或不被服务端支持 | 错误：模型 [model名称] 不存在或不被支持 |
| APIConnectionError | 网络中断、base_url错误或服务器未响应 | 错误：无法连接到API服务器 |
| APIError | API请求格式错误、权限不足等服务端异常 | API请求失败：[错误详情] |
| 其他未捕获异常 | 代码逻辑错误、意外数据格式等 | 发生未知错误：[错误详情] |
五、实现代码
六、使用示例输出
（一）成功输出示例
AI回复内容：
人工智能是研究、开发用于模拟、延伸和扩展人的智能的理论、方法、技术及应用系统的一门新的技术科学，其核心包括机器学习、自然语言处理、计算机视觉等领域，广泛应用于医疗、金融、交通等行业，正深刻改变着人类的生产和生活方式。（二）错误输出示例
AI回复内容：
错误：API密钥无效或未授权七、注意事项
1.
api_key、base_url、model等参数为必要值，如需修改需直接调整函数内对应字段。2.
messages列表包含对话历史，system角色用于设定模型行为，user角色为用户当前提问 。3.
temperature参数建议设置在0 - 2之间，0表示生成内容更确定，2表示更具随机性 。4.
5.
messages参数，追加历史对话记录（包含assistant角色的回复） 。6.
openai Python库，使用前需确保已安装（pip install openai ）。