小树工作室API站 开发者使用文档

1. 平台概述

小树工作室API站 是兼容 OpenAI 协议的高并发聚合 AI 转发服务，聚合主流大模型、多模态模型，标准 OpenAI 协议兼容，支持流式响应、多模型切换、按量 Token 计费。适用于 AI 客户端、机器人、二次开发、智能问答系统等专业场景。

2. 基础接入信息

2.1 接口基础地址

https://ai.lianhaotian.com/v1

2.2 传输规范

• 仅支持 HTTPS 加密请求
• 统一 UTF-8 / JSON 数据格式
• 对话接口 POST，状态接口 GET
• 标准 SSE 流式输出兼容

2.3 授权请求头

Content-Type: application/json
Authorization: Bearer 你的Token

3. 核心接口

3.1 对话补全接口

地址：/chat/completions    方式：POST

请求参数

参数	类型	必填	说明
model	string	是	模型标识
messages	array	是	对话上下文
stream	bool	否	是否流式返回
temperature	float	否	随机性 0~1
max_tokens	int	否	最大生成长度

请求示例

{
    "model": "gpt-3.5-turbo",
    "stream": false,
    "temperature": 0.7,
    "messages": [
        {"role":"user","content":"你好"}
    ]
}

响应示例

{
    "id": "chatcmpl-xxx",
    "object": "chat.completion",
    "model": "gpt-3.5-turbo",
    "choices": [
        {
            "message": {"role":"assistant","content":"你好，我是AI助手"},
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 2,
        "completion_tokens": 12,
        "total_tokens": 14
    }
}

6. 错误码大全

状态码	说明	解决
200	请求成功	正常
400	参数错误	检查JSON格式
401	授权失败	核对Token
429	请求过载	降低并发
500	服务异常	重试或换模型
502	模型超时	稍后重试

7. 开发最佳实践

• 客户端超时设置 30s+
• 5xx 错误支持 2 次重试
• 禁止前端明文存放 Token
• 禁止高频死循环请求

8. 常见问题

为什么 401？

Token 错误、已重置、账号未登录、请求头格式错误。

为什么额度充足却报错？

高倍率模型消耗更快，实际已超额。