LFAPI DOCUMENTATION

把模型接入,保持简单。

LFAPI 提供兼容 OpenAI 的统一入口。创建 API Key 后,可直接使用标准 SDK、已有客户端或 HTTP 请求接入可用模型。

协议OpenAI-compatible API
基础地址https://ai.liangfeng.net.cn/v1
认证方式Bearer API Key

01 / QUICK START

快速开始

完成下面三步即可发起第一条请求。LFAPI 的账户、API Key 和额度均在控制台管理。

  1. 1
    注册并登录

    使用符合站点要求的邮箱完成注册。新账户的可用额度由管理员审核后发放。

  2. 2
    创建 API Key

    进入控制台的令牌页面,创建一枚只用于当前应用的 Key,并妥善保存。

  3. 3
    确认可用模型

    先请求模型列表,再在业务侧选择返回列表中的模型 ID。

02 / AUTHENTICATION

使用 API Key 鉴权

所有面向模型的请求都需要在 HTTP 请求头中携带 Bearer Token。不要把 Key 提交到仓库、前端代码或公开日志。

HTTP Header
Authorization: Bearer $LFAPI_API_KEY

03 / API REFERENCE

兼容 API

以下路径均以 https://ai.liangfeng.net.cn/v1 为基础地址。请求字段与 OpenAI 兼容接口保持一致;实际可用模型以模型列表为准。

GET
/models

获取当前 API Key 可调用的模型。

POST
/chat/completions

创建对话补全请求,支持非流式和流式返回。

POST
/responses

使用 Responses 兼容接口发送多模态或工具调用请求。

cURL
curl https://ai.liangfeng.net.cn/v1/models \
  -H "Authorization: Bearer $LFAPI_API_KEY"

04 / STREAMING

启用流式响应

在 /chat/completions 请求体中设置 stream: true,服务端将通过 Server-Sent Events 逐段返回生成内容。客户端需要持续读取连接直到收到结束事件。

JSON body
{
  "model": "your-model-id",
  "messages": [{ "role": "user", "content": "你好" }],
  "stream": true
}

05 / ACCOUNT

账号与额度

额度先于调用。

新注册账户默认额度为 0。获得管理员发放的额度后,再创建并使用 API Key。额度不足时,LFAPI 会拒绝上游请求,避免产生未授权消耗。

请仅使用自己的 API Key。发现 Key 泄露时,应立即在控制台删除旧 Key 并创建新 Key。

06 / RESPONSES

常见响应

状态含义处理建议
401未提供或无效的 API Key检查 Authorization 请求头。
403当前 Key 无访问权限确认账号、分组或模型授权。
429请求频率受限退避重试,降低并发。
5xx上游或临时服务异常保留请求 ID 后重试;持续出现时联系管理员。

准备好接入了吗?

从控制台创建 API Key,使用模型列表确认你的应用可调用的模型。

打开控制台